Merge pull request #394 from fitztrev/study-schemas

Update study schemas

doc/specs/schemas/StudyImportPgnChapters.yaml

@@ -1 +1,53 @@
-example: { 'chapters': [{ 'id': 'WTvnkWAL', 'name': 'Game 2' }] }
+type: object
+
+properties:
+  chapters:
+    type: array
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+          description: The chapter ID
+        name:
+          type: string
+          description: The chapter name
+        players:
+          type: array
+          minItems: 2
+          maxItems: 2
+          items:
+            type: object
+            properties:
+              name:
+                type:
+                  - string
+                  - "null"
+                description: The player name
+              rating:
+                type: integer
+                description: The player rating
+        status:
+          type: string
+          description: The chapter status
+
+example:
+  {
+    "chapters": [
+      {
+        "id": "iBjmYBya",
+        "name": "test 2",
+        "players": [
+          {
+            "name": "Carlsen, Magnus",
+            "rating": 2837
+          },
+          {
+            "name": "Chadaev, Nikolay",
+            "rating": 2580
+          }
+        ],
+        "status": "1-0"
+      }
+    ]
+  }

doc/specs/schemas/StudyMetadata.yaml

@@ -1,2 +1,25 @@
+type: object
+
+properties:
+  id:
+    type: string
+    description: The study ID
+  name:
+    type: string
+    description: The study name
+  createdAt:
+    type: integer
+    format: int64
+    description: The study creation date
+  updatedAt:
+    type: integer
+    format: int64
+    description: The study last update date
+
 example:
-  { 'id': 'WTvnkWAL', 'name': 'Guess the move', 'createdAt': 1463756350225, 'updatedAt': 1469965025205 }
+  {
+    "id": "WTvnkWAL",
+    "name": "Guess the move",
+    "createdAt": 1463756350225,
+    "updatedAt": 1469965025205
+  }

doc/specs/tags/broadcasts/api-broadcasts-top.yaml

@@ -30,6 +30,6 @@ get:
             type: string
             default: "'*'"
       content:
-        application/x-ndjson:
+        application/json:
           schema:
             $ref: "../../schemas/BroadcastTop.yaml"

doc/specs/tags/games/api-import.yaml

@@ -33,5 +33,14 @@ post:
       content:
         application/json:
           schema:
+            type: object
+            properties:
+              id:
+                type: string
+                description: The game ID
+                example: "R6iLjwz5"
+              url:
+                type: string
+                format: uri
+                description: The game URL
             example: {"id": "R6iLjwz5", "url": "https://lichess.org/R6iLjwz5"}
-

doc/specs/tags/studies/api-study-by-username.yaml

@@ -28,6 +28,4 @@ get:
       content:
         application/x-ndjson:
           schema:
-            type: array
-            items:
-              $ref: '../../schemas/StudyMetadata.yaml'
+            $ref: '../../schemas/StudyMetadata.yaml'