Update of Spotify's OpenAPI definition (#192)

* Automated update of Spotify's OpenAPI definition

* Fix response type of the new "get-audiobook-chapters" operation

Author: sonallux

fixed-spotify-open-api.yml

@@ -463,6 +463,37 @@ paths:
           $ref: '#/components/responses/TooManyRequests'
       security:
       - oauth_2_0: []
+  /audiobooks/{id}/chapters:
+    x-spotify-docs-display-name: audiobook-chapters
+    x-spotify-docs-category: Audiobooks
+    get:
+      operationId: get-audiobook-chapters
+      tags:
+      - Audiobooks
+      - Chapters
+      x-spotify-docs-endpoint-name: Get an Audiobook's Chapters
+      x-spotify-docs-console-url: /console/get-audiobook-chapters/?id=5thw29eqjomhIDMY1XKsLk
+      summary: |
+        Get Audiobook Chapters
+      description: |
+        Get Spotify catalog information about an audiobook's chapters.<br />
+        **Note: Audiobooks are only available for the US market.**
+      parameters:
+      - $ref: '#/components/parameters/PathAudiobookId'
+      - $ref: '#/components/parameters/QueryMarket'
+      - $ref: '#/components/parameters/QueryLimit'
+      - $ref: '#/components/parameters/QueryOffset'
+      responses:
+        "200":
+          $ref: '#/components/responses/ChaptersPagingObject'
+        "401":
+          $ref: '#/components/responses/Unauthorized'
+        "403":
+          $ref: '#/components/responses/Forbidden'
+        "429":
+          $ref: '#/components/responses/TooManyRequests'
+      security:
+      - oauth_2_0: []
   /chapters/{id}:
     x-spotify-docs-display-name: chapters
     x-spotify-docs-category: Chapters

official-spotify-open-api.yml

@@ -478,6 +478,38 @@ paths:
       security:
         -
           oauth_2_0: []
+  /audiobooks/{id}/chapters:
+    x-spotify-docs-display-name: audiobook-chapters
+    x-spotify-docs-category: Audiobooks
+    get:
+      operationId: get-audiobook-chapters
+      tags:
+        - Audiobooks
+        - Chapters
+      x-spotify-docs-endpoint-name: Get an Audiobook's Chapters
+      x-spotify-docs-console-url: /console/get-audiobook-chapters/?id=5thw29eqjomhIDMY1XKsLk
+      summary: |
+        Get Audiobook Chapters
+      description: |
+        Get Spotify catalog information about an audiobook's chapters.<br />
+        **Note: Audiobooks are only available for the US market.**
+      parameters:
+        - $ref: '#/components/parameters/PathAudiobookId'
+        - $ref: '#/components/parameters/QueryMarket'
+        - $ref: '#/components/parameters/QueryLimit'
+        - $ref: '#/components/parameters/QueryOffset'
+      responses:
+        "200":
+          $ref: "#/components/responses/PagingObject"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "429":
+          $ref: "#/components/responses/TooManyRequests"
+      security:
+        -
+          oauth_2_0: []
   /chapters/{id}:
     x-spotify-docs-display-name: chapters
     x-spotify-docs-category: Chapters

spotify-web-api-open-api/src/main/resources/patches/path-get-audiobook-chapters.yml

@@ -0,0 +1,8 @@
+description: update response type to ChaptersPagingObject
+operations:
+  - op: test
+    path: "$.paths./audiobooks/{id}/chapters.get.responses.200.$ref"
+    value: '#/components/responses/PagingObject'
+  - op: set
+    path: "$.paths./audiobooks/{id}/chapters.get.responses.200.$ref"
+    value: '#/components/responses/ChaptersPagingObject'