Idempotenza

Ottieni una chiave API

Un errore di rete può lasciarti nel dubbio se una pubblicazione sia stata creata. Invia un header Idempotency-Key con POST /v1/posts e POST /v1/media, e riprova con la stessa chiave: Sofia risponde ciò che ha risposto la prima volta e non crea nulla due volte.

bash

curl -X POST https://api.sofia-post.com/api/v1/posts \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d @post.json

Usa una nuova chiave casuale (un UUID) per ogni nuova pubblicazione, e la stessa chiave per ogni nuovo tentativo di quella pubblicazione.
La stessa chiave con un body diverso risponde 422 idempotency_key_reused.
Finché la prima richiesta è ancora in corso, la stessa chiave risponde 409 idempotency_in_progress: riprova un momento dopo.