---
title: TracePass API documentation
description: REST API reference for the TracePass Digital Product Passport platform.
canonical: "https://www.tracepass.eu/bg/docs"
locale: bg
source: "https://www.tracepass.eu/bg/docs"
---

# TracePass API documentation

> REST API reference for the TracePass Digital Product Passport platform.

Reference for the TracePass REST API — products, Digital Product Passports, parties, batches, and the JSON-LD tenant export.

## Бърз старт

Създайте първия си паспорт за пет минути — регистрирайте се, генерирайте API ключ, публикувайте паспорт, сканирайте QR.

- [Бърз старт](https://www.tracepass.eu/bg/docs/quickstart.md)

## Удостоверяване

Два метода за удостоверяване — API ключ (Bearer) и OAuth 2.0 с PKCE — плюс Idempotency-Key за безопасни повторения и планови лимити за v1.

- [Удостоверяване](https://www.tracepass.eu/bg/docs/authentication.md)

## Паспорти

Създаване, актуализиране, спиране, архивиране и масово импортиране на Цифрови продуктови паспорти. Включва блока parties за веригата от икономически оператори.

- [Създаване на паспорт](https://www.tracepass.eu/bg/docs/create-passport.md)
- [Прочитане на паспорт](https://www.tracepass.eu/bg/docs/get-passport.md)
- [Рендиране на QR на паспорт](https://www.tracepass.eu/bg/docs/passport-qr.md)
- [Проверка на съответствието на паспорт](https://www.tracepass.eu/bg/docs/passport-compliance.md)
- [Списък на паспортите](https://www.tracepass.eu/bg/docs/list-passports.md)
- [Актуализиране на едно поле в паспорт](https://www.tracepass.eu/bg/docs/update-field.md)
- [Upsert на икономически оператор (party)](https://www.tracepass.eu/bg/docs/upsert-party.md)
- [Спиране на паспорт](https://www.tracepass.eu/bg/docs/suspend-passport.md)
- [Архивиране на паспорт (необратимо)](https://www.tracepass.eu/bg/docs/archive-passport.md)
- [Окончателно изтриване на паспорт](https://www.tracepass.eu/bg/docs/delete-passport.md)
- [Масово създаване на паспорти](https://www.tracepass.eu/bg/docs/batch-create-passports.md)

## Продукти

Каталожният слой — продукти, изображения, партиди. Един продукт може да има много паспорти (по един за всяко серийно изделие).

- [Създаване на продукт](https://www.tracepass.eu/bg/docs/create-product.md)
- [Прочитане на продукт](https://www.tracepass.eu/bg/docs/get-product.md)
- [Списък на продуктите](https://www.tracepass.eu/bg/docs/list-products.md)
- [Актуализиране на продукт](https://www.tracepass.eu/bg/docs/update-product.md)
- [Качване на изображение на продукт](https://www.tracepass.eu/bg/docs/upload-product-image.md)
- [Архивиране на продукт](https://www.tracepass.eu/bg/docs/archive-product.md)
- [Окончателно изтриване на продукт](https://www.tracepass.eu/bg/docs/delete-product.md)

## Шаблони

Полевите схеми за DPP категориите — открийте какво изисква съвместим паспорт във всяка категория: брой полета и приложим регламент, преди да го изградите.

- [Списък на шаблоните по категория](https://www.tracepass.eu/bg/docs/list-templates.md)
- [Прочитане на шаблон по категория](https://www.tracepass.eu/bg/docs/get-template.md)

## Webhooks

HMAC-подписана доставка за жизнения цикъл на паспортите. Retry ladder, проверка на подпис, защита срещу повторение.

- [Webhooks](https://www.tracepass.eu/bg/docs/webhooks.md)

## Експорти

Масов JSON-LD експорт за тенант — всички продукти, паспорти и шаблони, които притежавате, като един каноничен документ.

- [Масов JSON-LD експорт за тенант](https://www.tracepass.eu/bg/docs/tenant-export.md)

## EPCIS 2.0

GS1 EPCIS 2.0 — експортирайте история на събития на паспорт, заснемайте събития от партньори и ERP, заявявайте хранилището на събития.

- [Експорт на EPCIS събитията на паспорт](https://www.tracepass.eu/bg/docs/passport-epcis-export.md)
- [Заснемане на EPCIS събития](https://www.tracepass.eu/bg/docs/capture-events.md)
- [Заявяване на задача за заснемане](https://www.tracepass.eu/bg/docs/capture-job.md)
- [Заявяване на EPCIS събития](https://www.tracepass.eu/bg/docs/query-events.md)

## MCP сървър

MCP сървър — AI асистенти (Claude, Cursor, IDE) управляват продукти, паспорти, EPCIS събития. Хостван endpoint или локален npm пакет.

- [MCP сървър](https://www.tracepass.eu/bg/docs/mcp.md)

## n8n community node

Автоматизирайте TracePass работни процеси в n8n без код — продукти, паспорти, EPCIS събития. Безплатен community node, инсталируем от всяка n8n инстанция.

- [n8n community node](https://www.tracepass.eu/bg/docs/n8n.md)

## Грешки и лимити

Справочник: HTTP кодове (4xx и 5xx), форма на пакета грешки, дневни лимити за безплатното ниво и експоненциално изчакване при 429.

- [Грешки и лимити](https://www.tracepass.eu/bg/docs/errors.md)