API Challenge OpenAPI Files
Download an OpenAPI JSON file to use in your REST Client.
File Download Links
OpenAPI JSON files are available in the default format and in specific OpenAPI versions. The default openapi.json endpoint currently returns OpenAPI v 3.1.
- OpenAPI v 3.0 JSON standard validation download - less validation download
- OpenAPI v 3.1 JSON standard validation download - less validation download
- OpenAPI v 3.2 JSON standard validation download - less validation download
Open OpenAPI 3.2 In Online UIs
Tool support for OpenAPI 3.2 is still emerging, so these links help compare how each UI handles the same file.
Standard validation
Open the user-facing API Challenges OpenAPI 3.2 file.
Open in Swagger Open in OpenAPI Explorer Open in Scalar Open in Stoplight Elements Open in Zudoku Open in Redoc
Less validation
Open the more permissive API Challenges OpenAPI 3.2 file for testing edge cases.
Open in Swagger Open in OpenAPI Explorer Open in Scalar Open in Stoplight Elements Open in Zudoku Open in Redoc
QUERY Method Support
OpenAPI 3.2 describes QUERY as a native method. OpenAPI 3.0 and 3.1 include QUERY details using a vendor extension so tools that do not yet understand OpenAPI 3.2 can still load the file.
Example QUERY request:
QUERY /api/todos HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Accept: application/json
doneStatus=true
About API Challenge's Normal OpenAPI File
The Normal OpenAPI File is intended for use as though you were a user.
It only lists endpoints that are valid to use, and has additional validation on the URL Parameters that you can enter.
When this type of file is loaded into a Swagger UI Generation application it makes it easy to USE the API but makes it harder to TEST the API.
About API Challenge's Permissive OpenAPI File
The Permissive OpenAPI File is intended for testing.
It lists all the end points with more Verbs i.e. even verbs that the API defines as not available.
The parameters are also possible to send as empty and type validation is not performed on the parameter values. This makes it possible to use Swagger UI applications to test more extreme situations.