---
title: Пакет връзки за търговци
description: "Връзките към всички публикувани паспорти на продукт и към страницата на модела: JSON по страници, CSV или ZIP до 50 000 реда. За искане на търговец (ESPR)."
canonical: "https://www.tracepass.eu/bg/docs/get-product-links"
locale: bg
source: "https://www.tracepass.eu/bg/docs/get-product-links"
---

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

> Връзките към всички публикувани паспорти на продукт и към страницата на модела: JSON по страници, CSV или ZIP до 50 000 реда. За искане на търговец (ESPR).

```http
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 четене.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes. |
| `id` | path | string (24 hex chars) | yes | ID на продукта. |
| `format` | query | string | no | `json` (по подразбиране), `csv` или `zip`. |
| `limit` | query | integer (1–5000) | no | Редове на страница, по подразбиране 1000. Само за `json`. |
| `cursor` | query | string | no | `nextCursor` от предишната страница. Само за `json`. |

## Examples

```bash
# 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
```

```typescript
const base = `https://app.tracepass.eu/api/v1/products/${id}/links`;
const headers = { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` };

let cursor: string | null = null;
do {
  const url = new URL(base);
  if (cursor) url.searchParams.set("cursor", cursor);
  const res = await fetch(url, { headers });
  if (!res.ok) throw new Error(`Links failed: ${res.status}`);
  const page = await res.json();
  for (const p of page.passports) console.log(p.serial, p.passportUrl);
  cursor = page.nextCursor;
} while (cursor);
```

```python
import os, requests

url = f"https://app.tracepass.eu/api/v1/products/{product_id}/links"
headers = {"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"}
params = {}
while True:
    res = requests.get(url, headers=headers, params=params)
    res.raise_for_status()
    page = res.json()
    for p in page["passports"]:
        print(p["serial"], p["passportUrl"])
    if not page["nextCursor"]:
        break
    params["cursor"] = page["nextCursor"]
```

## Responses

### 200 — JSON страница

```json
{
  "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
}
```

### 400 — Невалиден параметър

```json
{ "error": "invalid_limit", "message": "limit must be an integer from 1 to 5000" }
```

### 404 — Не е намерен

```json
{ "error": "Product not found" }
```

### 413 — Пакетът е твърде голям

```json
{ "error": "pack_too_large", "message": "…", "max": 50000 }
```

## Related

- [Рендиране на QR на страницата на модела](https://www.tracepass.eu/bg/docs/get-product-model-qr.md)
- [Прочитане на продукт](https://www.tracepass.eu/bg/docs/get-product.md)
