TracePass
Продукти

Рендиране на QR на страницата на модела

Рендира QR кода на страницата на модела на продукта, чистия GS1 адрес /01/{gtin}, посочен в GET /api/v1/products/{id}/links. Страницата на модела показва само публичните стойности, еднакви във всеки публикуван екземпляр, затова кодът е подходящ за онлайн обява или за търговец; всеки екземпляр запазва собствения си паспорт. Черен на прозрачен фон. Брои се като едно v1 четене.

GET/api/v1/products/{id}/links/model-qr
Изтегли OpenAPI 3.1
GET/api/v1/products/{id}/links/model-qr

Рендиране на QR на страницата на модела

Рендира QR кода на страницата на модела на продукта, чистия GS1 адрес /01/{gtin}, посочен в GET /api/v1/products/{id}/links. Страницата на модела показва само публичните стойности, еднакви във всеки публикуван екземпляр, затова кодът е подходящ за онлайн обява или за търговец; всеки екземпляр запазва собствения си паспорт. Черен на прозрачен фон. Брои се като едно v1 четене.

Връща 404 model_not_found, когато продуктът няма публикуван GS1 паспорт с този GTIN (т.е. няма страница на модела), 400 invalid_gtin, когато gtin не е 14 цифри, и 400 gtin_required, когато публикуваните паспорти на продукта носят повече от един GTIN, а gtin липсва.

Параметри в пътя

  • idзадължително

    string (24 hex chars)

    ID на продукта.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Query параметри

  • format

    string

    svg (по подразбиране) или png.

    e.g. png

  • gtin

    string (14 digits)

    Нужен само когато публикуваните паспорти на продукта носят повече от един GTIN.

    e.g. 09506000134352

Хедъри

  • Authorizationзадължително

    string

    Bearer <token> — или tp_ API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Заявка

# SVG (default)
curl -sS https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.svg

# PNG for one GTIN
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?format=png&gtin=09506000134352" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.png

Отговор

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>