docs: Schemas used in generic extension endpoints are combined using JSON Subschemas (#1482)

This applies the JSON Schema "$ref" feature to pull the object schemas
into the payload schema as subschemas. Doing so allows us to validate
the example against the overall schema, which found errors (now fixed).

Author: lisad

extensions/data-transfer/portability-data-transfer-generic/README.md

@@ -1,6 +1,7 @@
 {
   "$schema" : "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://id.schemas.pub/org/dtinit.org/dtp/media-0.1.0",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/album-schema",
+  "title": "Schema for Album metadata in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "description": {

…-data-transfer-generic/media-schema.json …-data-transfer-generic/album-schema.jsonextensions/data-transfer/portability-data-transfer-generic/media-schema.json renamed to extensions/data-transfer/portability-data-transfer-generic/album-schema.json extensions/data-transfer/portability-data-transfer-generic/media-schema.json renamed to extensions/data-transfer/portability-data-transfer-generic/album-schema.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/calendar-schema",
+  "title": "Schema for Calendar object info in data-transfer-project generic endpoints",
   "$defs": {
     "CalendarEventTime": {
       "type": "object",

extensions/data-transfer/portability-data-transfer-generic/calendar-schema.json

@@ -1,4 +1,7 @@
 {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/error-schema",
+  "title": "Schema for Album metadata in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "error": {

extensions/data-transfer/portability-data-transfer-generic/error-schema.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/file-schema",
+  "title": "Schema for file (blob) metadata in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "dateModified": {

extensions/data-transfer/portability-data-transfer-generic/file-schema.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/folder-schema",
+  "title": "Schema for folder metadata in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "path": {

extensions/data-transfer/portability-data-transfer-generic/folder-schema.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/payload-schema",
+  "title": "Schema for payload wrapper in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "apiVersion": {
@@ -9,9 +11,14 @@
       "type": "object",
       "description": "The inner payload, which contains data from one of the described data verticals",
       "minProperties": 1,
-      "anyOf": [{
-        "$ref": "media-schema.json"
-      }]
+      "anyOf": [
+        { "$ref": "album-schema" },
+        { "$ref": "calendar-schema" },
+        { "$ref": "file-schema" },
+        { "$ref": "folder-schema" },
+        { "$ref": "photo-and-video-schema" },
+        { "$ref": "social-posts-schema" }
+      ]
     },
     "schemaSource": {
       "type": "string",

extensions/data-transfer/portability-data-transfer-generic/payload-schema.json

@@ -1,5 +1,7 @@
 {
   "$schema" : "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/photo-and-video-schema",
+  "title": "Schema for photo and video metadata in data-transfer-project generic endpoints",
   "$defs": {
     "FavoriteInfo": {
       "type": "object",

extensions/data-transfer/portability-data-transfer-generic/photo-and-video-schema.json

@@ -3,28 +3,28 @@
   "schemaSource": ".../SocialPostsSerializer.java",
   "apiVersion": "0.1.0",
   "payload": {
-    "@type": "SocialActivityData",
+    "@type": "SocialActivity",
     "metadata": {
       "@type": "SocialActivityMetadata",
       "actor": {
         "@type": "SocialActivityActor",
         "id": "321",
         "name": "Steve",
-        "url": null
+        "url": "http://example.org/actor/321"
       }
     },
     "activity": {
       "@type": "SocialActivityModel",
       "id": "456",
-      "published": 1731604863.845677,
+      "published": "1731604863.845677",
       "type": "NOTE",
       "attachments": [
         {
           "@type": "SocialActivityAttachment",
           "type": "IMAGE",
           "url": "foo.com",
           "name": "Foo",
-          "content": null
+          "content": "Example content"
         }
       ],
       "location": {
@@ -35,7 +35,7 @@
       },
       "title": "Hello world!",
       "content": "Hi there",
-      "url": null
+      "url": "http://example.org/post/foo"
     }
   }
 }

…nsfer-generic/media-payload-example.json …generic/social-post-payload-example.jsonextensions/data-transfer/portability-data-transfer-generic/media-payload-example.json renamed to extensions/data-transfer/portability-data-transfer-generic/social-post-payload-example.json extensions/data-transfer/portability-data-transfer-generic/media-payload-example.json renamed to extensions/data-transfer/portability-data-transfer-generic/social-post-payload-example.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://id.schemas.pub/o/dtinit.org/dtp/social-posts-schema",
+  "title": "Schema for social post object data in data-transfer-project generic endpoints",
   "type": "object",
   "properties": {
     "activity": {