TracePass
Inizia ora
Passaporti

Annullare un esito dell'EU DPP Registry annotato per errore

Cancella un esito annotato con `POST /api/v1/passports/{id}/registration`; il parametro di query obbligatorio `environment` indica quale. Non cambia nulla nell'EU DPP Registry stesso: corregge ciò che TracePass conserva per il passaporto. L'annullamento viene registrato.

DELETE/api/v1/passports/{id}/registration
Scarica OpenAPI 3.1
DELETE/api/v1/passports/{id}/registration

Annullare un esito dell'EU DPP Registry annotato per errore

Cancella un esito annotato con `POST /api/v1/passports/{id}/registration`; il parametro di query obbligatorio `environment` indica quale. Non cambia nulla nell'EU DPP Registry stesso: corregge ciò che TracePass conserva per il passaporto. L'annullamento viene registrato.

**`environment=acceptance`** rimuove il test annotato nell'ambiente di accettazione (`registryAcceptanceTest`).

**`environment=production`** riporta il passaporto allo stato "preparato": `placeOnMarketStatus`, `placedOnMarketAt`, `registrationId` e `registrationMode` vengono cancellati, l'indirizzo congelato (`registryUpi`) e la preparazione restano, e le parti dell'operatore vengono sbloccate. Si può annullare solo un'annotazione con `registrationMode: "website"`, mai una registrazione confermata da un registro EN 18222.

Se non c'è un'annotazione di quel tipo da annullare, la chiamata risponde **409** `nothing_to_undo`. **Solo piani a pagamento** (`402` su Free). Le chiamate OAuth devono agire per un amministratore o un proprietario. Restituisce il passaporto dopo l'annullamento. Conta come una scrittura v1.

Parametri di percorso

  • idobbligatorio

    string (24 hex chars)

    ID del passaporto.

Parametri di query

  • environmentobbligatorio

    "production" | "acceptance"

    Quale esito annotato annullare.

    e.g. production

Header

  • Authorizationobbligatorio

    string

    `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Richiesta

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

Risposta

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

Endpoint correlati