درخواست‌های ایدمپوتنت

قطع‌شدن اتصال هرگز نباید به رزرو تکراری منجر شود. روی درخواست‌های ایجاد، هدر Idempotency-Key را بفرستید؛ تکرار درخواست با همان کلید، به‌جای ساختن منبع دوم، همان پاسخ اول را برمی‌گرداند.

نحوهٔ کار#

برای هر عملیات منطقی یک کلید یکتا بسازید (UUID انتخاب خوبی است) و آن را روی درخواست POST ایجاد سفارش یا رزرو بفرستید.

curl -X POST https://api.simorghapi.com/v3/HAPI/flights/orders \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2b8c1a-3e4d-4a6b-9c7e-1d2f3a4b5c6d" \
  -d '{ … }'

اگر درخواست را با همان کلید تکرار کنید، پاسخ اصلی دوباره با هدر Idempotency-Replayed: true برگردانده می‌شود و هیچ سفارش جدیدی ساخته نمی‌شود.

کجا از آن استفاده کنیم#

روی هر درخواستی که سفارش یا رزروی را ایجاد یا تغییر می‌دهد کلید ایدمپوتنسی بفرستید: ایجاد سفارش، درخواست صدور بلیت، تأیید، لغو یا استرداد. درخواست‌های خواندنی و جست‌وجوها به آن نیازی ندارند.