Изградете с TracePass v1 API
Справочник за всеки публичен REST endpoint в TracePass — CRUD на паспорти, parties, продукти, webhooks, масов JSON-LD експорт. Ръчно написана OpenAPI 3.1 спецификация за изтегляне; работи с Postman, Insomnia, Bruno и всеки OpenAPI генератор на клиенти.
Преди да започнете
TracePass v1 REST API е интеграционната повърхност, която всеки екип на продукт, обвързан с ESPR, използва, за да създава, обновява и публикува Цифрови продуктови паспорти в мащаб. Той огледално отразява модела на данните, който маркетинговият сайт, интерфейсът на платформата и интеграциите MCP / n8n четат — паспорт, създаден през API, е байт-идентичен на създадения в интерфейса, със същото покритие на полета по Регламент (ЕС) 2024/1781 (ESPR) и същото GS1 Digital Link QR разпознаване.
Версиониране. Всеки endpoint е под /api/v1/…; v1 е стабилна повърхност — добавяме полета и endpoints без предупреждение и никога не премахваме или преименуваме. v2 ще се появи под /api/v2/… с 12 месеца припокриване с v1 преди каквото и да е оттегляне. OpenAPI 3.1 спецификацията е каноничният справочник; този текст е ръководство върху нея.
Удостоверяване + лимити. Удостоверявате се с API ключ за работно пространство чрез header Authorization: Bearer <key>. Дневните лимити важат само за Free (100 v1 записа на ден) и Basic (200 на ден) като предпазна мярка срещу злоупотреба с безплатния план; от Starter до Enterprise нямат дневна квота. Поддръжката на Idempotency-Key и насоките за повторение при 429 са на страниците удостоверяване и грешки и лимити на честотата.
Бърз старт
Създайте първия си паспорт за пет минути — регистрирайте се, генерирайте API ключ, публикувайте паспорт, сканирайте QR.
Преглед Бърз стартУдостоверяване
Два метода за удостоверяване — API ключ (Bearer) и OAuth 2.0 с PKCE — плюс Idempotency-Key за безопасни повторения и планови лимити за v1.
Преглед УдостоверяванеПаспорти
11 endpointsСъздаване, актуализиране, спиране, архивиране и масово импортиране на Цифрови продуктови паспорти. Включва блока parties за веригата от икономически оператори.
Преглед ПаспортиПродукти
7 endpointsКаталожният слой — продукти, изображения, партиди. Един продукт може да има много паспорти (по един за всяко серийно изделие).
Преглед ПродуктиШаблони
2 endpointsПолевите схеми за DPP категориите — открийте какво изисква съвместим паспорт във всяка категория: брой полета и приложим регламент, преди да го изградите.
Преглед ШаблониWebhooks
HMAC-подписана доставка за жизнения цикъл на паспортите. Retry ladder, проверка на подпис, защита срещу повторение.
Преглед WebhooksЕкспорти
1 endpointМасов JSON-LD експорт за тенант — всички продукти, паспорти и шаблони, които притежавате, като един каноничен документ.
Преглед ЕкспортиEPCIS 2.0
4 endpointsGS1 EPCIS 2.0 — експортирайте история на събития на паспорт, заснемайте събития от партньори и ERP, заявявайте хранилището на събития.
Преглед EPCIS 2.0MCP сървър
MCP сървър — AI асистенти (Claude, Cursor, IDE) управляват продукти, паспорти, EPCIS събития. Хостван endpoint или локален npm пакет.
Преглед MCP сървърn8n community node
Автоматизирайте TracePass работни процеси в n8n без код — продукти, паспорти, EPCIS събития. Безплатен community node, инсталируем от всяка n8n инстанция.
Преглед n8n community nodeГрешки и лимити
Справочник: HTTP кодове (4xx и 5xx), форма на пакета грешки, дневни лимити за безплатното ниво и експоненциално изчакване при 429.
Преглед Грешки и лимити