Idempotensi

Dapatkan kunci API

Kesalahan jaringan bisa membuat Anda ragu apakah postingan sudah dibuat. Kirim header Idempotency-Key pada POST /v1/posts dan POST /v1/media, lalu coba ulang dengan kunci yang sama: Sofia menjawab seperti jawaban pertama dan tidak membuat apa pun dua kali.

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

Gunakan kunci acak baru (UUID) untuk setiap postingan baru, dan kunci yang sama untuk setiap percobaan ulang postingan itu.
Kunci yang sama dengan body berbeda dijawab 422 idempotency_key_reused.
Selagi permintaan pertama masih berjalan, kunci yang sama dijawab 409 idempotency_in_progress: coba lagi sebentar lagi.