OpenAPI документът е единен, структуриран договор, описващ точно какво предлага едно REST API: всеки път, методите, които приема, полетата на всяка заявка и отговор, кодовете на състоянието и схемата за удостоверяване. Тъй като форматът е стандартизиран, инструменти като Postman, Insomnia и openapi-generator могат да го импортират, за да създадат клиентски SDK, mock сървъри и интерактивна документация автоматично.
OpenAPI 3.1 спецификацията на TracePass е публичният договор за изтегляне зад API и документацията — и все по-често това, което AI агентите четат първо, за да разберат как да управляват процеса с паспорти, преди да го извикат. Тя е REST аналогът на MCP сървъра: същите възможности, изложени като конвенционално HTTP API.
Често задавани въпроси
Какво добавя OpenAPI 3.1 спрямо по-ранните версии?
OpenAPI 3.1 привежда спецификацията в пълно съответствие с JSON Schema, така че моделите на заявки и отговори могат да се описват със същия речник, използван другаде в съвременните инструменти. Това прави договора по-чист за валидиране и по-лесен за консумиране от генератори на код и AI агенти.
Мога ли да импортирам OpenAPI спецификацията на TracePass в Postman?
Да. Спецификацията се публикува като файл OpenAPI 3.1 за изтегляне (YAML и JSON) и се импортира директно в Postman, Insomnia, Bruno или openapi-generator, за да генерира заявки, клиентски код и тестове срещу API на паспорта.