مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

تأیید نرخ

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

تأیید نرخ#

GET/v3/HAPI/hotels/rates/{id}

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

curl https://api.simorghapi.com/v3/HAPI/hotels/rates/hrt_Ym9va2FwcDphYmMxMjM \
  -H "Authorization: Bearer $ACCESS_TOKEN"

پاسخ#

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

{
  "object": "hotel_rate",
  "id": "hrt_Ym9va2FwcDphYmMxMjM",
  "check_in": "2026-11-14",
  "check_out": "2026-11-16",
  "nights": 2,
  "total": { "amount": "360.00", "currency": "USD" },
  "refundable": true,
  "hotel": { /* … */ },
  "rooms": [ /* … */ ],
  "cancellation": { "non_refundable": false, "policy_text": "…", "policies": [ /* … */ ] },
  "revalidated": true
}
پیش از سفارش، تأیید نرخ الزامی است. ایجاد سفارش از نرخی که در نشست فعلی تأیید نشده باشد، خطای 409 rate_not_revalidated برمی‌گرداند. درست پیش از ایجاد سفارش نرخ را تأیید کنید و total و cancellation برگشتی را بخوانید تا همان مبلغ و شرایط تأییدشده را از مشتری بگیرید و به او اعلام کنید.

خطاها#

وضعیتکدمعنا
404rate_not_foundشناسه ساختار نادرستی دارد یا شناسهٔ نرخ نیست.
409rate_expiredنرخ دیگر در دسترس نیست؛ یک جست‌وجوی تازه انجام دهید.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.