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