Verifica una modifica API prima del passaggio successivo

Una risposta 2xx dimostra che la route ha accettato il proprio contratto; una lettura specifica della route dimostra che il passo seguente può osservare lo stato previsto. X-D1-Bookmark di dosya ordina le letture della sessione D1, mentre il contenuto del file può risiedere in un oggetto dello spazio di lavoro esterno a tale ordine.

Prima di iniziare

• Definisci la condizione finale prima di inviare la modifica: ID, cartella padre, nome, stato di eliminazione, versione o dimensione esatta in byte.
• Verifica come la route gestisce le ripetizioni. Il caricamento in un’unica richiesta ha una chiave di idempotenza; un DELETE diretto può eliminare definitivamente il file alla seconda chiamata.
• Conserva stato e corpo della risposta come ricevuta dell’operazione. Se presente, conserva X-D1-Bookmark per le successive letture D1.

Passaggi

1. Leggi la risorsa e registra ID e stato attuali. Scarta un’ipotesi locale non aggiornata prima che diventi una richiesta di scrittura.
2. Invia una sola modifica con ambito limitato. Richiedi lo stato e i campi documentati, come { "ok": true, "name": "…" } per spostamento o rinomina oppure una ricevuta del file caricato.
3. Acquisisci X-D1-Bookmark quando la risposta lo fornisce. Invialo nella richiesta successiva per ordinare la sessione D1 di quella richiesta; non crea un ordine tra archivi per un oggetto dello spazio di lavoro.
4. Esegui la lettura di verifica adatta alla modifica: recupera lo stesso ID dopo uno spostamento o una rinomina, consulta l’elenco degli eliminati dopo lo spostamento nel cestino oppure recupera il file tramite l’ID restituito dal caricamento.
5. Confronta la lettura con la condizione finale definita. Un vecchio elenco vuoto non prova che l’elemento esista nel nuovo stato previsto.
6. Salva la ricevuta della modifica e lo stato verificato prima della prossima azione dipendente. Se la verifica non è conclusiva, fermati ed esamina la situazione invece di ripetere una scrittura non sicura.

Risultato previsto

La ricevuta e la lettura specifica della route concordano sulla stessa risorsa e sullo stato confermato. L’automazione successiva parte solo quando la condizione finale specifica dell’operazione è visibile; un bookmark aiuta solo quando la lettura usa D1.

Risoluzione dei problemi

La modifica è riuscita ma la lettura sembra non aggiornata. Verifica che la richiesta punti allo stesso ID e allo stesso spazio di lavoro. Trasmetti il bookmark della risposta per lo stato D1, ma valuta il contenuto dell’oggetto dello spazio di lavoro dalla risposta della route.

La risposta è andata persa. Prima leggi lo stato. Ripeti la richiesta solo se la route documenta l’idempotenza o la precondizione osservata dimostra che la richiesta originale non è stata applicata.

La vecchia posizione è vuota. Controlla la destinazione o l’elenco degli eliminati per ID; l’assenza non è una condizione finale completa.

Guide correlate

• Usa le operazioni sulle cartelle
• Guida rapida all’API REST