عدم التكرار (Idempotency)

احصل على مفتاح API

قد يتركك خطأ شبكي غير متأكد هل أُنشئ المنشور. أرسل الترويسة Idempotency-Key مع POST /v1/posts وPOST /v1/media، وأعد المحاولة بالمفتاح نفسه: تجيب Sofia بما أجابت به أول مرة ولا تنشئ شيئًا مرتين.

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

استخدم مفتاحًا عشوائيًا جديدًا (UUID) لكل منشور جديد، والمفتاح نفسه لكل إعادة محاولة لذلك المنشور.
المفتاح نفسه مع جسم مختلف يُجاب بـ 422 idempotency_key_reused.
بينما الطلب الأول لا يزال قيد التنفيذ، يُجاب المفتاح نفسه بـ 409 idempotency_in_progress: أعد المحاولة بعد قليل.