diff --git a/CHANGELOG.md b/CHANGELOG.md index f36732f..7d6e3c5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). -## [1.3.1] - 2026-03-?? +## [1.4.0] - 2026-03-?? - Add OAS 3.1 support, cross-version warnings, and fix nullable spacing, by @dcode. - Fix MARKDOWN style table separators to use minimum 3 hyphens (issue #39), reported by @michael-nok. @@ -13,6 +13,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Fix [#30](https://github.com/Neoteroi/essentials-openapi/issues/30): raise an error when trying to generate output from an older Swagger v2 specification file (these were never supported as there was never a `/mk/v2/` namespace, intentionally). +- Fix [#35](https://github.com/Neoteroi/essentials-openapi/issues/35): group response + codes in a tab group on MkDocs output, reported by @Andre601. ## [1.3.0] - 2025-11-19 diff --git a/openapidocs/__init__.py b/openapidocs/__init__.py index ce3e94f..39b806b 100644 --- a/openapidocs/__init__.py +++ b/openapidocs/__init__.py @@ -1,2 +1,2 @@ -__version__ = "1.3.1" +__version__ = "1.4.0" VERSION = __version__ diff --git a/openapidocs/mk/v3/views_mkdocs/partial/request-responses.html b/openapidocs/mk/v3/views_mkdocs/partial/request-responses.html index cfd00e1..e3a1503 100644 --- a/openapidocs/mk/v3/views_mkdocs/partial/request-responses.html +++ b/openapidocs/mk/v3/views_mkdocs/partial/request-responses.html @@ -1,63 +1,50 @@ {% for code, definition in operation.responses.items() %} - -
- {% if code == "default" -%}
- {{texts.other_responses}}
- {%- else -%}
- Response {{code}}
- {%- with phrase = get_http_status_phrase(code) -%}
- {%- if phrase -%}
- {{ phrase }}
- {%- endif -%}
+=== "{% if code == "default" %}{{texts.other_responses}}{% else %}{{code}}{% with phrase = get_http_status_phrase(code) %}{% if phrase %} {{ phrase }}{% endif %}{% endwith %}{% endif %}"
+ {%- if is_reference(definition) -%}
+ {%- with type_name = definition["$ref"].replace("#/components/responses/", "") %}
+ Refer to the common response description: {{type_name}}.
Refer to the common response description: {{type_name}}.
{{texts.response_headers}}
+ ??? hint "{{texts.schema_of_the_response_body}}" + ```json + {{handler.write_content_schema(definition) | indent(12) | safe}} + ``` + {% endfor %} + {% endwith -%} + {% endif -%} + {%- if definition.headers %} +{{texts.response_headers}}
-| {{texts.name}} | -{{texts.description}} | -{{texts.schema}} | -
|---|---|---|
{{header_name}} |
- {{header_definition.description}} | -- {%- with schema = header_definition.schema %} - {%- include "partial/schema-repr.html" -%} - {% endwith -%} - | -
| {{texts.name}} | +{{texts.description}} | +{{texts.schema}} | +
|---|---|---|
{{header_name}} |
+ {{header_definition.description}} | ++ {%- with schema = header_definition.schema %} + {%- include "partial/schema-repr.html" -%} + {% endwith -%} + | +
- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -142,76 +139,70 @@ Initializes a file upload operation. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "baseURL": { - "type": "string", - "nullable": true - }, - "fileId": { - "type": "string", - "nullable": true - }, - "fileName": { - "type": "string", - "nullable": true + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "baseURL": { + "type": "string", + "nullable": true + }, + "fileId": { + "type": "string", + "nullable": true + }, + "fileName": { + "type": "string", + "nullable": true + }, + "token": { + "type": "string", + "nullable": true + } }, - "token": { - "type": "string", - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - -Response headers
- -| Name | -Description | -Schema | -
|---|---|---|
X-Rate-Limit-Limit |
- The number of allowed requests in the current period | -integer | -
X-Rate-Limit-Remaining |
- The number of remaining requests in the current period | -integer | -
X-Rate-Limit-Reset |
- The number of seconds left in the current period | -integer | -
- Response 400 Bad Request -
-Refer to the common response description: IllegalInput.
- Response 401 Unauthorized -
-Refer to the common response description: Unauthorized.
Response headers
+ +| Name | +Description | +Schema | +
|---|---|---|
X-Rate-Limit-Limit |
+ The number of allowed requests in the current period | +integer | +
X-Rate-Limit-Remaining |
+ The number of remaining requests in the current period | +integer | +
X-Rate-Limit-Reset |
+ The number of seconds left in the current period | +integer | +
Refer to the common response description: IllegalInput.
Refer to the common response description: Unauthorized.
- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -333,19 +321,19 @@ Gets the list of categories supported by the system. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/Category" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Category" + } } - } - ``` - - + ``` + + @@ -382,13 +370,10 @@ codes. - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -401,19 +386,19 @@ codes. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/Country" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Country" + } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -465,19 +447,19 @@ ISO country codes. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/Country" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Country" + } } - } - ``` - - + ``` + + @@ -569,13 +551,10 @@ Gets a paginated set of downloads records. - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -666,30 +645,30 @@ Gets a paginated set of downloads records. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "items": { - "type": "array", + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { "items": { - "$ref": "#/components/schemas/ReleaseNodeDownload" + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNodeDownload" + }, + "nullable": true }, - "nullable": true + "total": { + "type": "integer", + "format": "int64" + } }, - "total": { - "type": "integer", - "format": "int64" - } - }, - "additionalProperties": false - } - ``` - - + "additionalProperties": false + } + ``` + + @@ -725,13 +704,10 @@ API health check - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -742,30 +718,30 @@ API health check ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "alive": { - "type": "boolean" - }, - "timestamp": { - "type": "string", - "format": "date-time" + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "alive": { + "type": "boolean" + }, + "timestamp": { + "type": "string", + "format": "date-time" + }, + "regionName": { + "type": "string", + "nullable": true + } }, - "regionName": { - "type": "string", - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "additionalProperties": false + } + ``` + + @@ -801,13 +777,10 @@ API health check - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -839,30 +812,30 @@ API health check ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "membership": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ProfessionalMembership" + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "membership": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ProfessionalMembership" + }, + "nullable": true }, - "nullable": true + "signature": { + "type": "string", + "nullable": true + } }, - "signature": { - "type": "string", - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "additionalProperties": false + } + ``` + + @@ -898,13 +871,10 @@ Returns information about the API itself. - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -915,31 +885,31 @@ Returns information about the API itself. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "version": { - "type": "string", - "nullable": true - }, - "buildNumber": { - "type": "string", - "nullable": true + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "version": { + "type": "string", + "nullable": true + }, + "buildNumber": { + "type": "string", + "nullable": true + }, + "contactEmail": { + "type": "string", + "nullable": true + } }, - "contactEmail": { - "type": "string", - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "additionalProperties": false + } + ``` + + @@ -983,13 +953,10 @@ Returns details about a release by id. - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -1082,92 +1049,92 @@ Returns details about a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
+=== "200 OK"- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -1411,92 +1372,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -1671,30 +1629,30 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "items": { - "type": "array", + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { "items": { - "$ref": "#/components/schemas/Release" + "type": "array", + "items": { + "$ref": "#/components/schemas/Release" + }, + "nullable": true }, - "nullable": true + "total": { + "type": "integer", + "format": "int64" + } }, - "total": { - "type": "integer", - "format": "int64" - } - }, - "additionalProperties": false - } - ``` - - + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -1794,23 +1749,23 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "id": { - "type": "string", - "format": "uuid" - } - }, - "additionalProperties": false - } - ``` - + Other possible types: text/json, text/plain + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "id": { + "type": "string", + "format": "uuid" + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -1864,19 +1816,19 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/CurrentRelease" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/CurrentRelease" + } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -1930,19 +1879,19 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/CurrentRelease" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/CurrentRelease" + } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -2064,19 +2010,19 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -2139,23 +2082,23 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "url": { - "type": "string", - "nullable": true - } - }, - "additionalProperties": false - } - ``` - + Other possible types: text/json, text/plain + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "url": { + "type": "string", + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -2218,23 +2158,23 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "uniqueDownloads": { - "type": "integer", - "format": "int32" - } - }, - "additionalProperties": false - } - ``` - + Other possible types: text/json, text/plain + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "uniqueDownloads": { + "type": "integer", + "format": "int32" + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -2406,92 +2343,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -2659,92 +2593,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -2922,92 +2853,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -3174,92 +3102,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -3398,92 +3323,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -3657,92 +3579,92 @@ Deletes a release by id. ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - Other possible types: text/json, text/plain + Other possible types: text/json, text/plain - ??? hint "Schema of the response body" - ```json - { - "required": [ - "creationTime", - "draft", - "eTag", - "name", - "updateTime" - ], - "type": "object", - "properties": { - "eTag": { - "maxLength": 50, - "minLength": 0, - "type": "string" - }, - "creationTime": { - "type": "string", - "format": "date-time" - }, - "updateTime": { - "type": "string", - "format": "date-time" - }, - "id": { - "type": "string", - "format": "uuid" - }, - "name": { - "maxLength": 250, - "type": "string" - }, - "description": { - "type": "string", - "nullable": true - }, - "draft": { - "type": "boolean" - }, - "requestedNotification": { - "type": "boolean" - }, - "categoryId": { - "type": "string", - "nullable": true - }, - "category": { - "$ref": "#/components/schemas/Category" - }, - "nodes": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseNode" + ??? hint "Schema of the response body" + ```json + { + "required": [ + "creationTime", + "draft", + "eTag", + "name", + "updateTime" + ], + "type": "object", + "properties": { + "eTag": { + "maxLength": 50, + "minLength": 0, + "type": "string" }, - "nullable": true - }, - "countries": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseCountry" + "creationTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "history": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseHistory" + "updateTime": { + "type": "string", + "format": "date-time" }, - "nullable": true - }, - "organizations": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ReleaseOrganization" + "id": { + "type": "string", + "format": "uuid" }, - "nullable": true - } - }, - "additionalProperties": false - } - ``` - - + "name": { + "maxLength": 250, + "type": "string" + }, + "description": { + "type": "string", + "nullable": true + }, + "draft": { + "type": "boolean" + }, + "requestedNotification": { + "type": "boolean" + }, + "categoryId": { + "type": "string", + "nullable": true + }, + "category": { + "$ref": "#/components/schemas/Category" + }, + "nodes": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseNode" + }, + "nullable": true + }, + "countries": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseCountry" + }, + "nullable": true + }, + "history": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseHistory" + }, + "nullable": true + }, + "organizations": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ReleaseOrganization" + }, + "nullable": true + } + }, + "additionalProperties": false + } + ``` + + diff --git a/tests/res/example2-output.md b/tests/res/example2-output.md index 5bb5c0b..c1f1d8f 100644 --- a/tests/res/example2-output.md +++ b/tests/res/example2-output.md @@ -79,13 +79,10 @@ List all pets - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -99,47 +96,44 @@ List all pets ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/Pet" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Pet" + } } - } - ``` - - -Response headers
- -| Name | -Description | -Schema | -
|---|---|---|
x-next |
- A link to the next page of responses | -string | -
- Other responses -
- -=== "application/json" + ``` + +Response headers
+ +| Name | +Description | +Schema | +
|---|---|---|
x-next |
+ A link to the next page of responses | +string | +
- Response 201 Created -
- -- Other responses -
- -=== "application/json" +=== "201 Created" +=== "Other responses" + === "application/json" + ```json { @@ -230,29 +218,29 @@ Create a pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "code", + "message" + ], + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + } } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -318,48 +303,45 @@ Info for a specific pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - }, - "category": { - "type": "string", - "enum": [ - "One", - "Two", - "Three" - ] + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "id", + "name" + ], + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "name": { + "type": "string" + }, + "tag": { + "type": "string" + }, + "category": { + "type": "string", + "enum": [ + "One", + "Two", + "Three" + ] + } } } - } - ``` - - - -- Other responses -
- -=== "application/json" + ``` +=== "Other responses" + + === "application/json" + + ```json { "code": 26, @@ -368,29 +350,29 @@ Info for a specific pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "code", + "message" + ], + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + } } } - } - ``` - - + ``` + +- Response 200 OK -
+=== "200 OK" diff --git a/tests/res/example3-output.md b/tests/res/example3-output.md index 7c32185..f541d8e 100644 --- a/tests/res/example3-output.md +++ b/tests/res/example3-output.md @@ -63,13 +63,10 @@ List all pets - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -83,47 +80,44 @@ List all pets ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/Pet" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/Pet" + } } - } - ``` - - -Response headers
- -| Name | -Description | -Schema | -
|---|---|---|
x-next |
- A link to the next page of responses | -string | -
- Other responses -
- -=== "application/json" + ``` + + +Response headers
+ +| Name | +Description | +Schema | +
|---|---|---|
x-next |
+ A link to the next page of responses | +string | +
- Response 201 Created -
- -- Other responses -
- -=== "application/json" +=== "201 Created" +=== "Other responses" + === "application/json" + ```json { @@ -181,29 +169,29 @@ Create a pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + + + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "code", + "message" + ], + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + } } } - } - ``` - - + ``` + +- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -253,48 +238,45 @@ Info for a specific pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "id", - "name" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64" - }, - "name": { - "type": "string" - }, - "tag": { - "type": "string" - }, - "category": { - "type": "string", - "enum": [ - "One", - "Two", - "Three" - ] + + + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "id", + "name" + ], + "properties": { + "id": { + "type": "integer", + "format": "int64" + }, + "name": { + "type": "string" + }, + "tag": { + "type": "string" + }, + "category": { + "type": "string", + "enum": [ + "One", + "Two", + "Three" + ] + } } } - } - ``` - - - -- Other responses -
- -=== "application/json" + ``` +=== "Other responses" + + === "application/json" + + ```json { "code": 26, @@ -303,29 +285,29 @@ Info for a specific pet ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - - - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "required": [ - "code", - "message" - ], - "properties": { - "code": { - "type": "integer", - "format": "int32" - }, - "message": { - "type": "string" + + + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "required": [ + "code", + "message" + ], + "properties": { + "code": { + "type": "integer", + "format": "int32" + }, + "message": { + "type": "string" + } } } - } - ``` - - + ``` + +- Response 200 OK -
+=== "200 OK" diff --git a/tests/res/example4-split-output.md b/tests/res/example4-split-output.md index 77c4e22..22a639f 100644 --- a/tests/res/example4-split-output.md +++ b/tests/res/example4-split-output.md @@ -110,13 +110,10 @@ Invite a user ``` - -- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json [ @@ -140,24 +137,21 @@ Invite a user ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "array", - "items": { - "$ref": "#/components/schemas/UserInformation" + ??? hint "Schema of the response body" + ```json + { + "type": "array", + "items": { + "$ref": "#/components/schemas/UserInformation" + } } - } - ``` - - - -- Response 401 Unauthorized -
-Refer to the common response description: Unauthorized.
Refer to the common response description: Unauthorized.
- Response 200 OK -
- -=== "application/json" +=== "200 OK" + === "application/json" + ```json { @@ -242,35 +233,32 @@ Retrieve all users ``` ⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information. - + - ??? hint "Schema of the response body" - ```json - { - "type": "object", - "properties": { - "data": { - "type": "array", - "items": { - "$ref": "#/components/schemas/UserInformation" + ??? hint "Schema of the response body" + ```json + { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "$ref": "#/components/schemas/UserInformation" + } + }, + "nextCursor": { + "type": "string", + "description": "Paginate through users by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first \"page\" of the collection.", + "nullable": true, + "example": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA" } - }, - "nextCursor": { - "type": "string", - "description": "Paginate through users by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first \"page\" of the collection.", - "nullable": true, - "example": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA" } } - } - ``` - - - -- Response 401 Unauthorized -
-Refer to the common response description: Unauthorized.
Refer to the common response description: Unauthorized.
- Response 200 OK -
-Refer to the common response description: UserInformation.
- Response 401 Unauthorized -
-Refer to the common response description: Unauthorized.
Refer to the common response description: UserInformation.
Refer to the common response description: Unauthorized.
- Response 200 OK -
-Refer to the common response description: UserInformation.
- Response 401 Unauthorized -
-Refer to the common response description: Unauthorized.
Refer to the common response description: UserInformation.
Refer to the common response description: Unauthorized.