ну как бы вопрос был про роутинг, я так понял это и подразумевалось rest. А так для общения по вебсокету обычно хватает и обычного протобуф файлика (proto) или любого другого описания такого стандарта, типа flatbuffer, capnproto и т.д., чтобы все было предельно понятно, какой апи 😊
а для рест апи лучше OpenAPI я красивее html документации и не видел))
Иногда, если юзается Postman  или Insomnia, тоже довольно красиво и удобно все можно юзать без этих опенапи)) без html докуметации, но с возможностью удобно тестить эту апи, и всегда можно выгнать тот же OpenAPI с постмана и ему подобных и опять же иметь красивую html документацию

и еще вопрос, когда следует делить апи на версии? а-ля /api/v1, /api/v2, и т.д.? при этом меняется просто сами роуты, пути к ресурсам и форматы запросов/ответов?

ну можно сразу добавить версионность, что на клиенте, что на сервере .env с версией api в зависимости от окружения dev/prod/whatever. gateway api роутов почти всегда один и тот же для версий, просто реализация отличается/допиливается в угоду performance

Kong :)

может кто знает, как обойти проверку на защиту дорожки авторскими правами на стрим в инсте?

ну как бы вопрос был про роутинг, я так понял это и подразумевалось rest. А так для общения по вебсокету обычно хватает и обычного протобуф файлика (proto) или любого другого описания такого стандарта, типа flatbuffer, capnproto и т.д., чтобы все было предельно понятно, какой апи 😊
а для рест апи лучше OpenAPI я красивее html документации и не видел))
Иногда, если юзается Postman  или Insomnia, тоже довольно красиво и удобно все можно юзать без этих опенапи)) без html докуметации, но с возможностью удобно тестить эту апи, и всегда можно выгнать тот же OpenAPI с постмана и ему подобных и опять же иметь красивую html документацию

Попробуй два трека склеить или сверху что-то наложить

Godzilla