دریافت اطلاعات رزرو هتل

یک رزرو هتل و وضعیت آن را بخوانید و مهلت پرداخت رزروِ نگه‌داشته‌شده را تمدید کنید.

دریافت رزرو#

POST/v2/Hotel/HotelBookingData

دسترسی نیازمند مجوز hotel_booking_data

رزرو را با UniqueIdـی که از مرحلهٔ رزرو گرفته‌اید یا با ClientUniqueId خودتان پیدا کنید. دست‌کم یکی را بفرستید.

پارامترهای بدنه#

نام	نوع	الزامی	توضیح
`SessionId`	string	الزامی	شناسهٔ نشست شما.
`UniqueId`	string	یکی از دو	شناسهٔ رزرو از رزرو.
`ClientUniqueId`	string	یکی از دو	شمارهٔ مرجع خودتان. دست‌کم یکی از این دو را بفرستید.

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelBookingData \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "HB-2026-004417"
  }'

const res = await fetch("https://api.simorghapi.com/api/v2/Hotel/HotelBookingData", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "HB-2026-004417"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.simorghapi.com/api/v2/Hotel/HotelBookingData",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "HB-2026-004417",
    },
)

data = res.json()

پاسخ#

فیلد	نوع	توضیح
`Success`	boolean	در صورت موفقیت `true`.
`UniqueId`	string	شناسهٔ رزرو.
`Status`	integer	کد وضعیت رزرو.
`HotelName`	string	نام هتل.
`CheckIn` / `CheckOut`	string	تاریخ‌های اقامت.
`NetRate`	number	مبلغ کل کسرشده، به دلار آمریکا.
`Rooms`	array of object	اتاق‌ها و مهمانان، همان‌طور که رزرو شده‌اند.
`Error`	object	در صورت موفقیت `null`.

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 20,
  "HotelName": "Hotel Le Marais",
  "CheckIn": "2026-10-15",
  "CheckOut": "2026-10-16",
  "NetRate": 148.00,
  "Currency": "USD",
  "Rooms": [
    {
      "Passengers": [
        { "FirstName": "Jane", "LastName": "Doe", "PassengerType": 1 }
      ]
    }
  ],
  "Error": null
}

تمدید مهلت پرداخت#

POST/v2/Hotel/HotelExtendPaymentDeadline

دسترسی نیازمند مجوز hotel_extend_payment_deadline

مهلت رزروی را که هنوز در حالت نگه‌داشته است جلو ببرید. پس از تأیید رزرو، چیزی برای تمدید باقی نمی‌ماند.

پارامترهای بدنه#

نام	نوع	الزامی	توضیح
`SessionId`	string	الزامی	شناسهٔ نشست شما.
`UniqueId`	string	الزامی	شناسهٔ رزرو نگه‌داشته‌شده.

{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "PaymentDeadline": "2026-10-10T18:00:00",
  "Error": null
}

دو نسخه. مسیرهای v1 یعنی /Hotel/HotelBookingData و /Hotel/HotelExtendPaymentDeadline همین عملیات را انجام می‌دهند. یکپارچه‌سازی‌های جدید باید از مسیرهای v2 بالا استفاده کنند.

خطاها#

کد	معنا	راه‌حل
`Err0106002`	نه `UniqueId` ارسال شده و نه `ClientUniqueId`.	دست‌کم یکی را بفرستید.
`Err0104002`	رزرو هتل پیدا نشد.	شناسه را بررسی کنید.
`Err0104003`	مهلت پرداخت قابل تمدید نیست.	رزرو در وضعیتی نیست که بتوان مهلتش را تمدید کرد.

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