دریافت و اعتبارسنجی مجدد پیشنهاد

پیش از رزرو، پیشنهاد را یک بار دیگر دریافت کنید. این کار آن را نزد منبع دوباره اعتبارسنجی می‌کند: قیمت نرخ را به‌روز می‌کند، در دسترس‌بودنش را تأیید می‌کند و سپس نرخ تأییدشده را ذخیره می‌کند تا بتوانید از آن سفارش بسازید.

دریافت پیشنهاد#

GET/v3/HAPI/flights/offers/{id}

به اسکوپ flights:read نیاز دارد. {id} همان شناسهٔ ofr_ حاصل از جست‌وجوست.

curl https://api.simorghapi.com/v3/HAPI/flights/offers/ofr_dHJhdmVscGF5b3V0cz... \
  -H "Authorization: Bearer $ACCESS_TOKEN"

پاسخ#

همان ساختار flight_offer که جست‌وجو برمی‌گرداند، با قیمت به‌روزشده و revalidated برابر true.

{
  "object": "flight_offer",
  "id": "ofr_dHJhdmVscGF5b3V0cz...",
  "owner": "TP",
  "validating_airline": "PC",
  "cabin_class": "economy",
  "total": { "amount": "412.00", "currency": "USD" },
  "base":  { "amount": "250.00", "currency": "USD" },
  "tax":   { "amount": "162.00", "currency": "USD" },
  "slices": [ /* … same shape as search … */ ],
  "revalidated": true
}

پیش از سفارش، اعتبارسنجی مجدد الزامی است. ایجاد سفارش از پیشنهادی که در نشست فعلی دوباره اعتبارسنجی نشده باشد، خطای 409 offer_not_revalidated برمی‌گرداند. همیشه درست پیش از ایجاد سفارش پیشنهاد را دریافت کنید و total برگشتی را بخوانید تا همان مبلغ تأییدشده را از مشتری بگیرید.

تغییر قیمت#

اگر نرخ تغییر کرده باشد، total اعتبارسنجی‌شده با قیمتی که در جست‌وجو دیده‌اید فرق می‌کند. پیش از رزرو، مبلغ جدید را به مسافر نشان دهید. شناسهٔ پیشنهاد تغییری نمی‌کند.

خطاها#

وضعیت	کد	معنا
404	`offer_not_found`	شناسه ساختار نادرستی دارد یا شناسهٔ پیشنهاد نیست.
409	`offer_expired`	پیشنهاد دیگر در کش نیست یا در دسترس نیست؛ یک جست‌وجوی تازه انجام دهید.

ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.