Idempotence

Obtenir une clé API

Une erreur réseau peut vous laisser dans le doute sur la création d’une publication. Envoyez un en-tête Idempotency-Key avec POST /v1/posts et POST /v1/media, et réessayez avec la même clé : Sofia répond ce qu’elle a répondu la première fois, et ne crée rien en double.

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

Utilisez une nouvelle clé aléatoire (un UUID) pour chaque nouvelle publication, et la même clé pour chaque nouvel essai de cette publication.
La même clé avec un corps différent répond 422 idempotency_key_reused.
Tant que la première requête est en cours, la même clé répond 409 idempotency_in_progress : réessayez un instant plus tard.