discord-api-spec/README.md

25 lines
1.3 KiB
Markdown
Raw Normal View History

2023-07-13 18:04:25 -04:00
# Discord OpenAPI Specification
2023-08-02 17:01:17 -04:00
This repository contains the public preview of the [OpenAPI 3.1 specification](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md) for [Discord's API](https://discord.com/developers/docs/reference). Currently, the spec is only available for the most recent Discord API version ([v10](https://discord.com/developers/docs/reference#api-versioning-api-versions)).
2023-07-13 18:04:25 -04:00
2023-08-02 17:15:06 -04:00
> ⚠️ The public preview of the OpenAPI spec is subject to breaking changes without advance notice, and should not be used within production environments.
2023-07-13 18:04:25 -04:00
## Usage
### Spec Files
Two versions of the spec are included—the standard spec and the preview spec:
2023-08-02 17:01:17 -04:00
- [`openapi.json`](specs/openapi.json) is the standard spec that contains the stable, public API.
- [`openapi_preview.json`](specs/openapi_preview.json) is the preview spec which contains unstable and/or experimental API features. **This should not be considered stable** or used in production environments.
2023-07-13 18:04:25 -04:00
### Integrating with Postman
To use the spec with Postman, you can view the [public collection](https://www.postman.com/discord-api).
2023-08-02 17:01:17 -04:00
## Contributing
OpenAPI spec contents are automatically generated, and therefore **we do not allow public contributions to this repo**.
2023-08-02 17:15:06 -04:00
🐛 For bug fixes or improvements, you can [open an issue](https://github.com/discord/discord-api-spec/issues).