TracePass
Продукти

Пакет връзки за търговци

Връща пакета връзки за търговци на продукт: всеки публикуван паспорт със сериен номер, URL на паспорта и статус, плюс URL на страницата на модела на продукта. Това е отговорът с едно извикване на искане от търговец по член 10, параграф 3, буква б) от ESPR, който изисква връзка към уебстраница или копие на носителя на данни в срок от пет работни дни от искането.

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

Пакет връзки за търговци

Връща пакета връзки за търговци на продукт: всеки публикуван паспорт със сериен номер, URL на паспорта и статус, плюс URL на страницата на модела на продукта. Това е отговорът с едно извикване на искане от търговец по член 10, параграф 3, буква б) от ESPR, който изисква връзка към уебстраница или копие на носителя на данни в срок от пет работни дни от искането.

Изброяват се само публикувани паспорти; чернови, паспорти в преглед, спрени, изтекли, архивирани и изтрити не се включват. URL използват потвърдения персонализиран домейн на компанията, ако има такъв. Страницата на модела (/01/{gtin}) е публична страница само със стойностите, верни за всеки екземпляр: името, описанието и изображенията на продукта, контактът на компанията и публичните стойности на полета, еднакви във всеки публикуван паспорт. Тя не съдържа данни на отделен екземпляр и данни с ограничен достъп. Не е паспорт. Продукт, чиито паспорти не са с GS1 адресиране, няма страница на модела и models е празен.

format=json (по подразбиране) е по страници в реда на ID на паспорта, най-много limit реда на страница (по подразбиране 1000, максимум 5000); подайте nextCursor от отговора като cursor за следващата страница. format=csv стриймва всеки публикуван паспорт с колони serial, passport_url, status. Това е машинен формат, затова не го отваряйте в електронна таблица без внимание. format=zip съдържа passports.csv (безопасен за електронни таблици), message.txt (кратък текст за препращане) и QR на страницата на модела като model-qr-{gtin}.png и връща 413 pack_too_large над 50 000 публикувани паспорта; тогава ползвайте csv. JSON съдържа qrApiUrl за всеки паспорт — API маршрут, който изисква вашите идентификационни данни, затова го няма в нито един файл, предназначен за търговец. Брои се като едно v1 четене.

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

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

    string (24 hex chars)

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

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Query параметри

  • format

    string

    json (по подразбиране), csv или zip.

    e.g. zip

  • limit

    integer (1–5000)

    Редове на страница, по подразбиране 1000. Само за json.

    e.g. 1000

  • cursor

    string

    nextCursor от предишната страница. Само за json.

Хедъри

  • 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

Заявка

# Paged JSON (default)
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?limit=1000" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# The file to send to a dealer: passports.csv, message.txt and the model page QR
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?format=zip" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o dealer-pack.zip

Отговор

{
  "productId": "6650a1b2c3d4e5f6a7b8c9d0",
  "productName": "Li-Ion 48V Battery Pack",
  "productModel": "BP-48V-100",
  "models": [
    {
      "gtin": "09506000134352",
      "modelUrl": "https://id.tracepass.eu/01/09506000134352",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?gtin=09506000134352"
    }
  ],
  "passports": [
    {
      "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
      "serial": "SN-0001",
      "passportUrl": "https://id.tracepass.eu/01/09506000134352/21/SN-0001",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png",
      "status": "published"
    }
  ],
  "nextCursor": null
}