Risorse · 107

Attività API asincrone

Accettare una richiesta non dimostra che il lavoro sia concluso.

Aggiornato · 2 min

Obiettivi di questa guida

  • Definire stati e permessi
  • Riprendere il controllo
  • Confermare l’esito

Verifica rapida

  • 202 dimostra che il lavoro terminerà?
  • Annullare elimina tutti gli effetti già prodotti?

Metodo passo passo

  1. 1

    Definire stati e permessi

    Distingui accettato, in attesa, attivo, completato, fallito e annullamento richiesto. HTTP 202 non garantisce successo. Autorizza stato, risultati e annullamento per account; l’identificativo non sostituisce i permessi.

    Account, operazione e identificativo riutilizzabile

  2. 2

    Riprendere il controllo

    Conserva il riferimento esistente. Definisci intervallo, durata, scadenza e comportamento se manca lo stato. Se esiste protezione dai duplicati, documentane la portata e prova la risposta persa prima di ripetere la richiesta.

    Stato, ora, intervallo e scadenza

  3. 3

    Confermare l’esito

    Prova annullamento durante elaborazione o pubblicazione, errore del processo e risultato scaduto. Verifica gli effetti residui e termina le interrogazioni a uno stato finale.

    Risultato, errore, annullamento ed effetti residui

Foglio di lavoro riutilizzabile

Completare con le proprie osservazioni autorizzate. Questi campi costituiscono un modello di lavoro, non risultati osservati.

CampoInformazioni da registrare
RiferimentoAccount, operazione e identificativo riutilizzabile
ControlloStato, ora, intervallo e scadenza
EsitoRisultato, errore, annullamento ed effetti residui
AccettazioneUna sola attività autorizzata ed esito verificato dopo interruzione

Esempio pratico fittizio

Situazione illustrativa

Esempio fittizio: la risposta di accettazione di un’esportazione si perde e la persona riprova.

Decisione e prove attese

Il test verifica se il contratto di ripetizione restituisce l’attività esistente. Senza tale garanzia occorre verificare la richiesta prima di crearne un’altra; l’interfaccia non dimostra unicità.

Indicatori di gestione

IndicatoreCosa misuraPrima azione
Attività fermeRichieste senza aggiornamento entro il termine stabilitoAssegnare verifica, ripresa o chiusura
RipresaControllo ripreso senza creare un’altra attivitàEsaminare riavvii e duplicati

Errori comuni

    Domande frequenti

    202 dimostra che il lavoro terminerà?

    No. Conferma l’accettazione per elaborazione, non l’esito finale. Consulta lo stato dell’operazione.

    Annullare elimina tutti gli effetti già prodotti?

    Non necessariamente. Conferma lo stato finale e riconcilia gli effetti esistenti.

    Riferimenti ufficiali

    I riferimenti supportano il metodo. Adattare i controlli al proprio contesto; non costituiscono una certificazione. I titoli dei riferimenti originali e i documenti di origine potrebbero essere in un'altra lingua.

    Riferimenti consultati il .