---
title: OpenAPI
description: OpenAPI е индустриалният стандарт за машинночетимо описание на REST API — неговите endpoints, параметри, формати на заявки и отговори и удостоверяване — в един спецификационен файл. TracePass публикува OpenAPI 3.1 спецификация, така че всеки инструмент или AI агент да може да открие и извика API на паспорта без специална документация.
canonical: "https://www.tracepass.eu/bg/glossary/openapi"
locale: bg
source: "https://www.tracepass.eu/bg/glossary/openapi"
---

# OpenAPI

> OpenAPI е индустриалният стандарт за машинночетимо описание на REST API — неговите endpoints, параметри, формати на заявки и отговори и удостоверяване — в един спецификационен файл. TracePass публикува OpenAPI 3.1 спецификация, така че всеки инструмент или AI агент да може да открие и извика API на паспорта без специална документация.

OpenAPI е индустриалният стандарт за машинночетимо описание на REST API — неговите endpoints, параметри, формати на заявки и отговори и удостоверяване — в един спецификационен файл. TracePass публикува OpenAPI 3.1 спецификация, така че всеки инструмент или AI агент да може да открие и извика API на паспорта без специална документация.

OpenAPI документът е единен, структуриран договор, описващ точно какво предлага едно REST API: всеки път, методите, които приема, полетата на всяка заявка и отговор, кодовете на състоянието и схемата за удостоверяване. Тъй като форматът е стандартизиран, инструменти като Postman, Insomnia и openapi-generator могат да го импортират, за да създадат клиентски SDK, mock сървъри и интерактивна документация автоматично.

OpenAPI 3.1 спецификацията на TracePass е публичният договор за изтегляне зад API и документацията — и все по-често това, което AI агентите четат първо, за да разберат как да управляват процеса с паспорти, преди да го извикат. Тя е REST аналогът на MCP сървъра: същите възможности, изложени като конвенционално HTTP API.

## FAQ

### Какво добавя OpenAPI 3.1 спрямо по-ранните версии?

OpenAPI 3.1 привежда спецификацията в пълно съответствие с JSON Schema, така че моделите на заявки и отговори могат да се описват със същия речник, използван другаде в съвременните инструменти. Това прави договора по-чист за валидиране и по-лесен за консумиране от генератори на код и AI агенти.

### Мога ли да импортирам OpenAPI спецификацията на TracePass в Postman?

Да. Спецификацията се публикува като файл OpenAPI 3.1 за изтегляне (YAML и JSON) и се импортира директно в Postman, Insomnia, Bruno или openapi-generator, за да генерира заявки, клиентски код и тестове срещу API на паспорта.

## Related terms

- [MCP (Model Context Protocol)](https://www.tracepass.eu/bg/glossary/mcp)
- [JSON-LD](https://www.tracepass.eu/bg/glossary/json-ld)
- [Цифров продуктов паспорт (DPP)](https://www.tracepass.eu/bg/glossary/digital-product-passport)
- [Оценка за надеждност](https://www.tracepass.eu/bg/glossary/confidence-score)