TracePass
Започнете
Паспорти

Адрес за EU DPP Registry на паспорт на батерия

Връща уникалния идентификатор на продукта (UPI), който се поставя в онлайн формуляра на EU DPP Registry за един публикуван паспорт на **батерия**, като `{ upi, preparedAt }`. Икономическият оператор регистрира паспорта на уебсайта на регистъра със собствения си EU Login (Product group: Batteries; Granularity: Item). TracePass подготвя адреса и записва, че го е подготвил; никога не подава нищо към регистъра.

POST/api/v1/passports/{id}/registry-upi
Изтегли OpenAPI 3.1
POST/api/v1/passports/{id}/registry-upi

Адрес за EU DPP Registry на паспорт на батерия

Връща уникалния идентификатор на продукта (UPI), който се поставя в онлайн формуляра на EU DPP Registry за един публикуван паспорт на **батерия**, като `{ upi, preparedAt }`. Икономическият оператор регистрира паспорта на уебсайта на регистъра със собствения си EU Login (Product group: Batteries; Granularity: Item). TracePass подготвя адреса и записва, че го е подготвил; никога не подава нищо към регистъра.

**Първото извикване фиксира адреса** в паспорта като `registryUpi`, а следващите извиквания връщат същия адрес. Регистърът пази URL адреса, който е получил, затова този адрес трябва да продължи да се отваря, дори ако домейнът на акаунта ви се промени по-късно. Всяко извикване записва подготовката в паспорта (`registrationPreparedAt`, `registrationPreparedVia: "form"`). Подготовката не е регистрация: след като регистърът отговори, запишете отговора му с `POST /api/v1/passports/{id}/registration`.

Отказите връщат **409** с код в `error`: `not_a_battery`, `not_published` (само публикуван паспорт може да бъде регистриран), `registered_in_production` (паспортът вече е регистриран в производствения регистър), `registry_not_ready` (паспортът има блокираща констатация от проверката за готовност за регистъра; `findingDetails` изброява констатациите, като блокиращите са първи, от същата проверка като `GET /api/v1/passports/{id}/registry-readiness`) и `invalid_upi` (адресът не е `https://` URL с най-много 2000 знака).

**Само за платени планове** (`402` при Free: паспорт на Free изтича след 30 дни). OAuth извикванията трябва да са от името на администратор или собственик. Без тяло на заявката. Брои се като едно v1 записване, и то само когато извикването е успешно. Поддържа `Idempotency-Key`.

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

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

    string (24 hex chars)

    ID на публикуван паспорт на батерия.

Хедъри

  • 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

  • Idempotency-Key

    string

    UUID v4.

Заявка

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registry-upi \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Idempotency-Key: 7c2e4a91-3d5b-4f8e-a6c0-1b9d2e4f6a80"

Отговор

{
  "upi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3",
  "preparedAt": "2026-11-06T10:00:00.000Z"
}

Свързани endpoints