OpenAPI
OpenAPI — машиночитаемая схема, описывающая все эндпоинты, параметры и ответы REST API, по которой можно генерировать клиентов.
Подробно
Этот API публикует документ OpenAPI 3.1 вместе с индексом llms.txt — именно это позволяет генератору SDK, коллекции Postman или агентному фреймворку понять поверхность, не читая прозу. Он же источник истины по форме запросов и кодам статусов. Изменения поведения анонсируются в changelog до выката, поэтому сгенерированного клиента можно пересобрать осознанно, а не обнаружить сломанным.
Также известно как
- swagger
- api schema