Skip to content

Latest commit

 

History

History
23 lines (15 loc) · 724 Bytes

File metadata and controls

23 lines (15 loc) · 724 Bytes

API Documentation

API documentation is rendered by FastAPI on /docs and /redoc paths using OpenAPI format.

AsyncAPI documentation is rendered using the AsyncAPI react components. It is available on /asyncapi path.

API versioning

Versioning an API at resource level provides a much more flexible approach than versioning the whole API.

The example books domain provides 2 endpoints to demonstrate this approach

  • /api/books/v1 (POST)
  • /api/books/v2 (POST)

/// note | Media type versioning

An improvement could be moving to media type versioning ///