Ein Batch-Endpunkt akzeptiert ein Array von Elementen – zu erstellende Datensätze, zu löschende IDs – in einer einzigen Anfrage und spart so einen Roundtrip pro Element. Da manche Elemente erfolgreich sein können, andere jedoch fehlschlagen, wird jedes Element separat in der Antwort gemeldet. Der Statuscode 207 Multi-Status kennzeichnet genau diese Situation: "look inside, the outcomes differ"
Der Antworttext enthält den Status jedes Elements, üblicherweise in der gleichen Reihenfolge wie in der Anfrage oder anhand einer vom Client angegebenen ID. Die Architekturen unterscheiden sich hinsichtlich der Atomarität: Manche Batches arbeiten nach dem Alles-oder-Nichts-Prinzip und geben einen einzelnen 4xx-Fehler zurück, falls ein Element ungültig ist; andere speichern die möglichen Ergebnisse und melden den Rest. Die API muss dokumentieren, welche Architektur dies vorsieht.
Ein 2xx-Statuscode bei einer Batch-Verarbeitung bedeutet, dass alles erfolgreich war. Der Statuscode 207 gehört zur Erfolgsklasse, und ein Client, der nur `response.ok` prüft, meldet Erfolg, obwohl die Hälfte seiner Datensätze abgelehnt wurde. Batch-Clients müssen die Ergebnisse für jedes Element einzeln prüfen.
POST /friends/v1/characters/bulk validiert jedes Element einzeln und antwortet mit 207, wenn einige fehlschlagen, und POST /friends/v1/characters/bulk-delete meldet Teilerfolge auf die gleiche Weise; senden Sie ein fehlerhaftes Element zusammen mit gültigen, um dies zu überprüfen.
Diese Seite auf Englisch lesen
Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs
Zuletzt aktualisiert