Annulla la transazione di accesso corrente

POST /fapi/v1/transactions/current:cancel · chiamato dall'host di accesso dell'ambiente

Annulla la transazione corrente. La transazione passa allo stato failed e il cookie della transazione viene rimosso.

Richiesta

Header:

Header Obbligatorio Descrizione
Idp-Client sì Identificatore dell'SDK.
Origin sì Deve essere esattamente https://<sign-in host>.
Idp-Csrf-Token sì Il csrf_token dell'oggetto transazione.

Nessun body.

Risposta

200 OK con la transazione annullata.

Transazioni headless vincolate a DPoP

Per una transazione avviata con un header DPoP, invia una nuova prova dalla stessa chiave (htm POST, htu questo URL) al posto di Idp-Csrf-Token.

Errori

Stato Codice Quando
403 origin_not_allowed Origin o Idp-Csrf-Token manca o è errato.
409 transaction_state_conflict La transazione non può più essere annullata.
410 transaction_expired La transazione è terminata.
401 invalid_dpop_proof La prova DPoP non è valida o è stata riutilizzata.

Esempio

curl -X POST https://example.keenauth.app/fapi/v1/transactions/current:cancel \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Idp-Csrf-Token: $CSRF_TOKEN" \
  -b cookies.txt