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