chore: update lichess api schema

Author: gameroman

specs/lichess-api.yaml

@@ -1,6 +1,6 @@
 openapi: "3.1.0"
 info:
-  version: 2.0.139
+  version: 2.0.143
   title: Lichess.org API reference
   contact:
     name: "Lichess.org API"
@@ -219,7 +219,8 @@ tags:
 
       Runs <https://github.com/lichess-org/lila-openingexplorer>.
 
-      **The endpoint hostname is not lichess.org but explorer.lichess.org.**
+      > [!important]
+      > The hostname for these endpoints is `explorer.lichess.org` and not `lichess.org`.
   - name: Puzzles
     description: |
       Fetch and solve [puzzles](https://lichess.org/training), view your puzzle history and dashboard.
@@ -241,7 +242,8 @@ tags:
     description: |
       Lookup positions from the [Lichess tablebase server](https://lichess.org/blog/W3WeMyQAACQAdfAL/7-piece-syzygy-tablebases-are-complete).
 
-      **The endpoint hostname is not lichess.org but tablebase.lichess.org.**
+      > [!important]
+      > The hostname for these endpoints is `tablebase.lichess.org` and not `lichess.org`.
   - name: Teams
     description: |
       Access and manage Lichess teams and their members.

specs/schemas/BroadcastGameEntry.yaml

@@ -20,6 +20,8 @@ properties:
     description: The change in rating for the player as a result of this game
   fideTC:
     $ref: "./FideTimeControl.yaml"
+  ongoing:
+    type: boolean
 
 required:
   - round

specs/schemas/BroadcastTour.yaml

@@ -62,6 +62,8 @@ properties:
     description: "Full tournament description in markdown format, or in HTML if the html=1 query parameter is set."
   teamTable:
     type: boolean
+  showTeamScores:
+    type: boolean
   url:
     type: string
     format: uri

specs/schemas/PuzzleAndGame.yaml

@@ -71,6 +71,9 @@ properties:
         type: integer
       fen:
         type: string
+      lastMove:
+        type: string
+        description: In UCI format, e.g. "e2e4"
       solution:
         type: array
         items:

specs/tags/externalengine/api-external-engine-id-analyse.yaml

@@ -1,5 +1,3 @@
-servers:
-  - url: https://engine.lichess.ovh
 parameters:
   - in: path
     name: id
@@ -13,6 +11,12 @@ post:
   summary: Analyse with external engine
   tags:
     - External engine
+  servers:
+    - url: https://engine.lichess.ovh
+    - url: http://localhost:{port}
+      variables:
+        port:
+          default: "9666"
   security: []
   description: |
     **Endpoint: `https://engine.lichess.ovh/api/external-engine/{id}/analyse`**

specs/tags/externalengine/api-external-engine-work-id.yaml

@@ -1,5 +1,3 @@
-servers:
-  - url: https://engine.lichess.ovh
 parameters:
   - in: path
     name: id
@@ -12,6 +10,12 @@ post:
   summary: Answer analysis request
   tags:
     - External engine
+  servers:
+    - url: https://engine.lichess.ovh
+    - url: http://localhost:{port}
+      variables:
+        port:
+          default: "9666"
   security: []
   description: |
     **Endpoint: `https://engine.lichess.ovh/api/external-engine/work/{id}`**

specs/tags/externalengine/api-external-engine-work.yaml

@@ -1,18 +1,22 @@
-servers:
-  - url: https://engine.lichess.ovh
 post:
   operationId: apiExternalEngineAcquire
   summary: Acquire analysis request
   tags:
     - External engine
+  servers:
+    - url: https://engine.lichess.ovh
+    - url: http://localhost:{port}
+      variables:
+        port:
+          default: "9666"
   security: []
   description: |
     **Endpoint: `https://engine.lichess.ovh/api/external-engine/work`**
     Wait for an analysis requests to any of the external engines that
     have been registered with the given `secret`.
     Uses long polling.
     After acquiring a request, the provider should immediately
-    [start streaming the results](#tag/external-engine/POST/api/external-engine/workid).
+    [start streaming the results](#tag/external-engine/POST/api/external-engine/work/{id}).
   requestBody:
     description: Provider credentials.
     required: true

specs/tags/games/api-games-user-username.yaml

@@ -185,13 +185,13 @@ get:
             type: string
             default: "'*'"
       content:
-        application/json:
+        application/x-ndjson:
           schema:
             oneOf:
               - $ref: "../../schemas/GamePgn.yaml"
               - $ref: "../../schemas/GameJson.yaml"
           examples:
             application/x-chess-pgn:
               $ref: "../../examples/games-apiGamesUserPgn.pgn.yaml"
-            application/json:
+            application/x-ndjson:
               $ref: "../../examples/games-apiGamesUserJson.json.yaml"

specs/tags/openingexplorer/lichess.yaml

@@ -1,5 +1,3 @@
-servers:
-  - url: https://explorer.lichess.org
 get:
   operationId: openingExplorerLichess
   summary: Lichess games
@@ -11,6 +9,12 @@ get:
     Example: `curl https://explorer.lichess.org/lichess?variant=standard&speeds=blitz,rapid,classical&ratings=2200,2500&fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR%20w%20KQkq%20-%200%201`
   tags:
     - Opening Explorer
+  servers:
+    - url: https://explorer.lichess.org
+    - url: http://localhost:{port}
+      variables:
+        port:
+          default: "9002"
   security:
     - OAuth2: []
   parameters:

specs/tags/openingexplorer/masters-pgn-gameId.yaml

@@ -1,5 +1,3 @@
-servers:
-  - url: https://explorer.lichess.org
 get:
   operationId: openingExplorerMasterGame
   summary: OTB master game
@@ -9,6 +7,12 @@ get:
     Example: `curl https://explorer.lichess.org/masters/pgn/aAbqI4ey`
   tags:
     - Opening Explorer
+  servers:
+    - url: https://explorer.lichess.org
+    - url: http://localhost:{port}
+      variables:
+        port:
+          default: "9002"
   security:
     - OAuth2: []
   parameters: