TracePass
Паспорти

Отмяна на погрешен запис за EU DPP Registry

Изчиства резултат, записан с `POST /api/v1/passports/{id}/registration`; задължителният параметър на заявката `environment` посочва кой. Това не променя нищо в самия EU DPP Registry: коригира това, което TracePass пази за паспорта. Отмяната се записва.

DELETE/api/v1/passports/{id}/registration
Изтегли OpenAPI 3.1
DELETE/api/v1/passports/{id}/registration

Отмяна на погрешен запис за EU DPP Registry

Изчиства резултат, записан с `POST /api/v1/passports/{id}/registration`; задължителният параметър на заявката `environment` посочва кой. Това не променя нищо в самия EU DPP Registry: коригира това, което TracePass пази за паспорта. Отмяната се записва.

**`environment=acceptance`** премахва записания тест в приемната среда (`registryAcceptanceTest`).

**`environment=production`** връща паспорта в състояние „подготвен“: `placeOnMarketStatus`, `placedOnMarketAt`, `registrationId` и `registrationMode` се изчистват, фиксираният адрес (`registryUpi`) и подготовката остават, а страните на оператора се отключват. Може да се отмени само запис с `registrationMode: "website"`, никога регистрация, потвърдена от регистър по EN 18222.

Когато няма такъв запис за отмяна, извикването връща **409** `nothing_to_undo`. **Само за платени планове** (`402` при Free). OAuth извикванията трябва да са от името на администратор или собственик. Връща паспорта след отмяната. Брои се като едно v1 записване.

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

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

    string (24 hex chars)

    ID на паспорта.

Query параметри

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

    "production" | "acceptance"

    Кой записан резултат да се отмени.

    e.g. production

Хедъри

  • 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

Заявка

curl -sS -X DELETE \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registration?environment=production" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "passport": {
    "_id": "6650b2c3d4e5f6a7b8c9d0e1",
    "status": "published",
    "registryUpi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3",
    "registrationPreparedAt": "2027-02-26T09:12:00.000Z",
    "registrationPreparedVia": "form"
  }
}