Где обычно прописывают версию API?

Версию API обычно указывают в нескольких местах:

• В URL-адресе, например, /api/v1/resource, чтобы клиент явно знал, к какой версии обращается.
• В заголовках HTTP-запроса или ответа, например, API-Version: 1.
• В документации API, где описаны все поддерживаемые версии и изменения между ними.

Такое явное указание версии помогает управлять изменениями и поддерживать обратную совместимость.