مستندات

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

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

رزرو هتل

با نرخ اعتبارسنجی‌شده و مشخصات مهمانان، یک اتاق را نگه دارید.

POST/v2/Hotel/HotelBook

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

پس از اعتبارسنجی نرخ، رزرو کنید. مهمانان و یک مخاطب اصلی را بفرستید. پاسخ یک UniqueId برمی‌گرداند. این فقط نگه‌داشتن موقت (hold) است و هنوز مبلغی کسر نمی‌شود. برای نهایی کردن، سفارش را ثبت کنید.

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

پارامترهای مسیر#

ندارد.

پارامترهای کوئری#

ندارد.

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

نامنوعالزامیتوضیح
SessionIdstringالزامیشناسهٔ نشست شما.
FareSourceCodestringالزامیکد اعتبارسنجی‌شده از بررسی نرخ.
PhoneNumberstringالزامیتلفن مخاطب اصلی.
Emailstringالزامیایمیل مخاطب اصلی.
HotelTransfersarrayباید باشداین فیلد باید حتماً وجود داشته باشد. اگر ترانسفری ندارید، [] بفرستید.
Nationalitystringاختیاریملیت مهمان اصلی (کد کشور ISO). برخی نرخ‌ها به ملیت وابسته‌اند.
ClientUniqueIdstringاختیاریشمارهٔ مرجع خودتان. بعداً در اطلاعات رزرو قابل استفاده است.
Notestringاختیاریدرخواست متنی آزاد که به هتل منتقل می‌شود.
Rooms array of object، الزامی

برای هر اتاق رزروشده یک عضو. تعداد باید با ترکیب اتاق‌هایی که جست‌وجو کرده‌اید یکی باشد.

نامنوعالزامیتوضیح
Passengersarray of objectالزامیمهمانان اتاق. دست‌کم یک نفر.
Passengers[].FirstNamestringالزامینام.
Passengers[].LastNamestringالزامینام خانوادگی.
Passengers[].PassengerTypeintegerالزامیکد نوع مهمان (بزرگسال یا کودک)، مطابق جست‌وجوی شما.
Passengers[].PassengerTitleintegerالزامیکد عنوان، مثلاً Mr، Mrs، Ms.
Passengers[].NationalIdstringاختیاریکد ملی، در صورتی که هتل لازم داشته باشد.
Passengers[].PassportNumberstringاختیاریشمارهٔ گذرنامه، در صورت نیاز.

درخواست#

curl -X POST https://api.simorghapi.com/api/v2/Hotel/HotelBook \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy",
    "PhoneNumber": "+441234567890",
    "Email": "traveller@example.com",
    "Nationality": "GB",
    "ClientUniqueId": "hotel-order-0001",
    "Rooms": [
      {
        "Passengers": [
          { "FirstName": "Jane", "LastName": "Doe", "PassengerType": 1, "PassengerTitle": 2 }
        ]
      }
    ],
    "HotelTransfers": []
  }'
const res = await fetch("https://api.simorghapi.com/api/v2/Hotel/HotelBook", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    FareSourceCode: "YmE6OTk4MjE6cnI3ZjMy",
    PhoneNumber: "+441234567890",
    Email: "traveller@example.com",
    Nationality: "GB",
    ClientUniqueId: "hotel-order-0001",
    Rooms: [
      { Passengers: [ { FirstName: "Jane", LastName: "Doe", PassengerType: 1, PassengerTitle: 2 } ] }
    ],
    HotelTransfers: []
  })
});

const data = await res.json();
import requests

res = requests.post(
    "https://api.simorghapi.com/api/v2/Hotel/HotelBook",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "FareSourceCode": "YmE6OTk4MjE6cnI3ZjMy",
        "PhoneNumber": "+441234567890",
        "Email": "traveller@example.com",
        "Nationality": "GB",
        "ClientUniqueId": "hotel-order-0001",
        "Rooms": [
            {"Passengers": [
                {"FirstName": "Jane", "LastName": "Doe", "PassengerType": 1, "PassengerTitle": 2}
            ]}
        ],
        "HotelTransfers": [],
    },
)

data = res.json()

پاسخ#

فیلدنوعتوضیح
Successbooleanدر صورت موفقیت true.
UniqueIdstringشناسهٔ رزرو. آن را برای سفارش، پیگیری و لغو نگه دارید.
Statusintegerوضعیت رزرو: نگه‌داشته‌شده و در انتظار سفارش.
Errorobjectدر صورت موفقیت null.
{
  "Success": true,
  "UniqueId": "HB-2026-004417",
  "Status": 10,
  "Error": null
}
این نگه‌داشتن موقت است، نه تأیید نهایی. در مرحلهٔ رزرو مبلغی کسر نمی‌شود. این نگه‌داشتن حدود ۱۵ دقیقه اعتبار دارد. پیش از انقضای آن، سفارش را ثبت کنید.

خطاها#

کدمعناراه‌حل
Err0106001یکی از فیلدهای الزامی مهمان یا مخاطب ارسال نشده است.فیلدی را که در پیام خطا آمده اصلاح کنید.
Err0102003این نرخ دیگر در دسترس نیست.نرخ را دوباره اعتبارسنجی کنید.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.