/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
}