API референция

REST API на qr3.app е достъпно на https://qr3.app/v1/ и следва изцяло конвенциите от Преглед на API (автентикация чрез Authorization: Bearer, грешки съгласно RFC 7807, Cursor-Pagination).

Първи стъпки

Преглед на API Версиониране, формат на заявки/отговори, идемпотентност, пагинация.

Автентикация API ключове, заглавни части за работни пространства, тестова среда срещу среда на живо.

Справка за грешки Типове грешки по RFC 7807 със статус кодове и примери.

Интерактивна справка OpenAPI 3.1 + Scalar-Playground — въведете токени и тествайте директно.

Ресурсни области

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

Организации и работни пространства Акаунти, работни пространства, членства и лимити на планове.

Уебхукове Абониране за събития, верификация на подписи, логове за доставка.

MCP и агенти Model Context Protocol — генериране на QR кодове и DPP от AI агенти.

Защита на данните и поверителност Експорт по GDPR, изтриване на акаунти, хеширане на IP адреси, съгласия.

Версиониране и отхвърляне Как се въвеждат нови полета и какво предизвиква разрушителни промени.

Специфични за DPP крайни точки

Всички крайни точки за Digital Product Passport са документирани в собствения им раздел Digital Product Passport — включително референции за схеми за батерии и текстил, валидатор за съответствие с ЕС, както и публичния GS1-Resolver.

Базови URL адреси за всяка среда

Среда	Базов URL	Цел
Production	`https://qr3.app/v1/`	Публично API на живо
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Предпроизводствен пилот (вижте `ENVIRONMENTS.md`)
Локална	`http://localhost:8787/v1/`	`pnpm --filter api dev`

Спецификацията на OpenAPI е достъпна на https://qr3.app/v1/openapi.json и се актуализира автоматично при всяко внедряване.