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