TracePass
API документация

Изградете с TracePass v1 API

Справочник за всеки публичен REST endpoint в TracePass — CRUD на паспорти, parties, продукти, webhooks, масов JSON-LD експорт. Ръчно написана OpenAPI 3.1 спецификация за изтегляне; работи с Postman, Insomnia, Bruno и всеки OpenAPI генератор на клиенти.

Бърз старт

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

Преглед Бърз старт

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

Удостоверяване с API ключ, семантика на Idempotency-Key и лимити на честотата според плана за v1.

Преглед Удостоверяване

Паспорти

8 endpoints

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

Преглед Паспорти

Продукти

5 endpoints

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

Преглед Продукти

Webhooks

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

Преглед Webhooks

Експорти

1 endpoint

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

Преглед Експорти

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

Справочник: HTTP кодове за статус, форма на пакета грешки, лимити по план, насоки за повторение.

Преглед Грешки и лимити