دموی زنده

یکپارچه‌سازی تأمین‌کننده هتل

یکپارچه‌سازی Hotelbeds API: محتوا، نگاشت و رزرو زنده

یکپارچه‌سازی Hotelbeds API دو کار است، نه یک کار. ابتدا محتوای هتل‌ها را دانلود و ذخیره می‌کنید، سپس با نرخ‌های زنده رزرو می‌کنید. PHPTRAVELS هر دو را در ماژول هتل خود انجام می‌دهد، با قرارداد و کلیدهای Hotelbeds خود شما.

  • همگام‌سازی Content API
  • جریان Booking API
  • نرخ‌های BOOKABLE و RECHECK
  • نگاشت هتل‌ها

API‌های Hotelbeds چگونه کنار هم قرار می‌گیرند

یکپارچه‌سازی Hotelbeds API: محتوا در یک سو، رزرو در سوی دیگر

Hotelbeds API‌های هتل خود را به دو بخش تقسیم می‌کند. Content API داده‌های ثابت را برمی‌گرداند: توضیحات، تصاویر، امکانات، نوع پذیرایی و اتاق‌ها. Booking API موجودی و قیمت زنده را برمی‌گرداند و رزرو را ثبت می‌کند. یک مرحله را در وسط انتخاب کنید تا ببینید از کدام فراخوانی‌ها استفاده می‌کند.

Content API

ثابت، در سمت شما ذخیره می‌شود
  • فهرست هتل‌هاhotels · from=1&to=1000همه هتل‌های پورتفوی شما، در صفحه‌هایی تا ۱٬۰۰۰ هتل در هر درخواست.
  • امکانات، پذیرایی و اتاق‌هاfacilities · boards · roomsجدول‌های کدی که کدهای Booking API را به واژه‌هایی قابل فهم برای مهمانان تبدیل می‌کنند.
  • تصاویرphotos.hotelbeds.com/giata/مسیرهای ناقص تصویر که به میزبان عکس Hotelbeds در اندازه دلخواه شما متصل می‌شوند.
  • تغییرات روزانهlastUpdateTimeپس از بارگذاری اول، یک درخواست روزانه با lastUpdateTime فقط تغییرات را برمی‌گرداند.

ترتیب درخواست‌ها

Booking API

زنده، برای هر مهمان فراخوانی می‌شود
  • موجودیPOST /hotelsاتاق‌ها، پذیرایی، قیمت‌ها و جریمه‌های لغو برای کدهای هتل، تاریخ‌ها و ترکیب مسافران شما.
  • بررسی نرخPOST /checkratesقیمت و شرایط به‌روز برای نرخی با برچسب RECHECK، همراه با گزینه‌های فروش بیشتر.
  • رزروPOST /bookingsrateKey انتخاب‌شده را با نام رزروکننده و مهمانان تأیید می‌کند و شماره مرجع را برمی‌گرداند.
  • لغوDELETE /bookings · simulateلغو را شبیه‌سازی می‌کند تا جریمه را نشان دهد، یا رزرو را واقعاً لغو می‌کند.
صفحه نمونه. فراخوانی‌ها طبق مستندات developer.hotelbeds.com است؛ جریان نشان می‌دهد PHPTRAVELS چگونه از آن‌ها استفاده می‌کند.

بیشتر پروژه‌های ناموفق Hotelbeds این دو بخش را با هم قاطی می‌کنند. آن‌ها Content API را هنگام جستجوی مهمان فراخوانی می‌کنند که کند است و، به هشدار Hotelbeds، ممکن است اعتبارنامه‌ها را مسدود کند. یا بدون کدهای ذخیره‌شده به‌صورت زنده جستجو می‌کنند و نمی‌توانند تصاویر یا امکانات را نشان دهند. PHPTRAVELS این دو را جدا نگه می‌دارد: محتوا در پس‌زمینه همگام می‌شود و هنگام انتظار مهمان فقط فراخوانی‌های موجودی، بررسی نرخ و رزرو اجرا می‌شوند.

اگر درباره خود تأمین‌کننده، محصولات آن و نحوه افتتاح حساب اطلاعات می‌خواهید، پروفایل تأمین‌کننده Hotelbeds را بخوانید. این صفحه درباره یکپارچه‌سازی فنی است.

انواع نرخ

چهار فیلد نرخ که فرایند پرداخت شما را تغییر می‌دهند

هر نرخ Hotelbeds چند ویژگی دارد که تعیین می‌کند آیا می‌توانید بلافاصله رزرو کنید، چه قیمتی را می‌توانید نمایش دهید و چه کسی پول را دریافت می‌کند. موتور شما باید این‌ها را در هر نتیجه بخواند.

فیلدحالت اولحالت دومکاری که PHPTRAVELS انجام می‌دهد

قابل رزرو یا نیازمند بررسی

rateType		BOOKABLE

نرخ به‌روز است. می‌توانید بدون فراخوانی دیگر آن را رزرو کنید.

RECHECK

ابتدا باید بررسی نرخ را فراخوانی کنید تا قیمت و شرایط به‌روز را بگیرید.

برای نرخ‌های RECHECK پیش از مرحله پرداخت بررسی نرخ را اجرا می‌کند و هر تغییری را به مهمان نشان می‌دهد.

خالص یا کمیسیونی

net · sellingRate		net

مدل خالص: قیمت‌ها خالص هستند و شما حاشیه سود خود را اضافه می‌کنید.

sellingRate

مدل کمیسیونی: کمیسیون از قبل در sellingRate است و این قیمت نهایی است.

قوانین افزایش قیمت شما را روی نرخ‌های خالص اعمال می‌کند و نرخ‌های کمیسیونی را با sellingRate می‌فروشد.

قیمت فروش ثابت

hotelMandatory		true

hotelMandatory برابر true است: باید با sellingRate بفروشید.

false · null

false یا خالی در نرخ خالص: می‌توانید حاشیه سود خود را تعیین کنید.

وقتی هتل الزام کند، قیمت نمایشی را روی sellingRate قفل می‌کند، صرف‌نظر از قانون افزایش قیمت.

زمان پرداخت مهمان

paymentType		AT_WEB

پرداخت هنگام ثبت رزرو، از طریق سایت شما دریافت می‌شود.

AT_HOTEL

مهمان مستقیماً به هتل پرداخت می‌کند.

نرخ را با برچسب پرداخت اکنون یا پرداخت در هتل مشخص می‌کند و فرایند پرداخت را متناسب با آن هدایت می‌کند.

مدل قیمت‌گذاری شما به قرارداد Hotelbeds بستگی دارد. به گفته Hotelbeds، مدیر فروش شما مدل مناسب کسب‌وکارتان را پیشنهاد می‌کند.

نگاشت هتل‌ها

هتل‌های Hotelbeds را با هتل‌هایی که اکنون می‌فروشید تطبیق دهید

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

نگاشت در PHPTRAVELS چگونه کار می‌کند

پس از هر همگام‌سازی محتوا، PHPTRAVELS هتل‌های Hotelbeds را بر اساس نام، نشانی، شهر و مختصات با فهرست هتل‌های شما مقایسه می‌کند. تطابق‌های نزدیک خودکار پیوند می‌خورند. موارد مشکوک منتظر تأیید یک کارمند می‌مانند و هتل‌های بدون تطابق را می‌توان به‌عنوان اقامتگاه جدید وارد کرد یا نادیده گرفت.

هتل‌های نگاشت‌شده یک صفحه، یک گالری و یک امتیاز نظرات مشترک در هتل دارند، در حالی که هر تأمین‌کننده نرخ‌ها و قوانین خود را حفظ می‌کند. همین نگاشت در سایت عمومی و پورتال سفر B2B شما استفاده می‌شود.

نگاشت هتل‌ها
  • Harbour View Hotelلیسبون48291397%تطبیق‌یافته
  • Old Town Suitesپراگ11735492%تطبیق‌یافته
  • Palm Court Resortدبی66201874%بررسی
  • Casa Azul Boutiqueسویا–0%بدون تطابق
  • Northern Lights Lodgeترومسو90522766%بررسی
  • Riverside Apartmentsبوداپست33076198%تطبیق‌یافته

صفحه نمونه با هتل‌ها و کدهای ساختگی.

Hotelbeds با XML یا JSON

هر درخواست امضا می‌شود و آزمایش از مقیاس کوچک شروع می‌شود

تیم‌ها هنوز Hotelbeds XML را جستجو می‌کنند، اما مستندات فعلی درخواست‌های JSON را نشان می‌دهد. در هر حال مجموعه عملیات یکسان است و هر درخواست دو هدر دارد.

availability-request.sh (نمونه)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
دو هدر
Api-key با کلید شما، و X-Signature: هش SHA256 از کلید، رمز و زمان فعلی بر حسب ثانیه.
میزبان آزمایشی
به گفته Hotelbeds، سرورهای آزمایشی با محیط اصلی یکسان‌اند، اما رزروها واقعی نیستند و از کارت‌ها برداشتی نمی‌شود.
۵۰ درخواست در روز
کلیدهای جدید یک محیط ارزیابی با سهمیه ۵۰ درخواست در روز باز می‌کنند. سهمیه بیشتر با گواهی‌دهی می‌آید.
بدون فراخوانی زنده محتوا
Hotelbeds هشدار می‌دهد که فراخوانی Content API به‌صورت بلادرنگ ممکن است اعتبارنامه‌ها را مسدود کند. PHPTRAVELS هرگز این کار را نمی‌کند.

برنامه‌ریز همگام‌سازی محتوا

فهرست هتل‌های شما به چند فراخوانی Content API نیاز دارد

به گفته Hotelbeds، فهرست هتل‌ها در صفحه‌هایی تا ۱٬۰۰۰ هتل می‌آید و پس از بارگذاری اول، یک درخواست روزانه با lastUpdateTime فقط تغییرات را برمی‌گرداند. اعداد خود را وارد کنید تا همگام‌سازی را برنامه‌ریزی کنید.

درخواست‌ها برای بارگذاری کامل اول
20
درخواست‌ها در هر به‌روزرسانی روزانه
3
روزهای لازم برای یک بار بارگذاری با سهمیه ارزیابی
1

فقط برآورد، برای فهرست هتل‌ها. جدول‌های کد و تصاویر چند فراخوانی دیگر اضافه می‌کنند. با سهمیه ارزیابی ۵۰ درخواست در روز، ابتدا با یک مقصد آزمایش کنید.

چک‌لیست راه‌اندازی

پیش از رفتن به محیط زنده چه چیزهایی آماده باشد

Hotelbeds شما را از طریق داشبورد خود از ارزیابی به گواهی‌دهی و سپس به کلیدهای زنده می‌برد. این‌ها نکاتی است که یکپارچه‌سازی Hotelbeds API باید ابتدا پوشش دهد، و نحوه پوشش آن‌ها در PHPTRAVELS.

  • کلیدهای ارزیابی در پنل مدیریت افزوده شده و میزبان آزمایشی انتخاب شده
  • Content API با پایگاه داده شما همگام شده و به‌روزرسانی روزانه زمان‌بندی شده
  • هتل‌ها با فهرست شما نگاشت شده و تطابق‌های مشکوک بررسی شده
  • نرخ‌های RECHECK پیش از پرداخت از بررسی نرخ عبور می‌کنند
  • وقتی hotelMandatory برابر true است، sellingRate رعایت می‌شود
  • توضیحات نرخ و جریمه‌های لغو پیش از پرداخت مهمان نمایش داده می‌شوند
  • واچر مرجع Hotelbeds و توضیحات نرخ را نشان می‌دهد
  • لغو ابتدا شبیه‌سازی و سپس تأیید می‌شود و جریمه ثبت می‌شود

مراحل گواهی‌دهی و دسترسی زنده را Hotelbeds برای قرارداد و بازار شما تعیین می‌کند.

هزینه

یک لایسنس برای موتور، قرارداد خودتان با Hotelbeds

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

Startup
مجوز یک‌باره
لایسنس یک‌باره
Agency
مجوز یک‌باره
لایسنس یک‌باره
Enterprise
مجوز یک‌باره
لایسنس یک‌باره

Hotelbeds یکی از چند منبع هتلی است که می‌توانید هم‌زمان اجرا کنید. ببینید در کنار RateHawk در نمای کلی API‌های سفر چه جایگاهی دارد، یا تأمین‌کنندگان را در فهرست تأمین‌کنندگان XML مقایسه کنید.

مشاهده قیمت‌هادموی هتل‌ها را امتحان کنید

پرسش‌های متداول

پرسش‌های یکپارچه‌سازی Hotelbeds API

آنچه توسعه‌دهندگان و شرکت‌های سفر پیش از اتصال Hotelbeds می‌پرسند.

گفتگو با فروش

دو بخش. همگام‌سازی پس‌زمینه با Content API که هتل‌ها، تصاویر، امکانات، پذیرایی و اتاق‌ها را در پایگاه داده شما ذخیره می‌کند، و یک جریان زنده با Booking API برای موجودی، بررسی نرخ، رزرو و لغو. PHPTRAVELS هر دو را در ماژول هتل خود اجرا می‌کند.

مردم هنوز آن را Hotelbeds XML می‌نامند، اما مستندات فعلی Hotelbeds درخواست‌ها و پاسخ‌های JSON را نشان می‌دهد. عملیات در هر حال یکسان است و PHPTRAVELS قالب را برای شما مدیریت می‌کند.

نرخ BOOKABLE از قبل به‌روز است و بلافاصله قابل رزرو است. نرخ RECHECK ابتدا به فراخوانی بررسی نرخ نیاز دارد که قیمت و شرایط فعلی را برمی‌گرداند. PHPTRAVELS این فراخوانی را پیش از مرحله پرداخت انجام می‌دهد.

کند است و Hotelbeds هشدار می‌دهد که استفاده بلادرنگ از Content API ممکن است به مسدود شدن اعتبارنامه‌ها منجر شود. محتوا باید صفحه به صفحه دانلود، ذخیره و روزی یک بار با lastUpdateTime به‌روز شود. PHPTRAVELS دقیقاً همین‌طور کار می‌کند.

بله. در Hotelbeds ثبت‌نام می‌کنید، قرارداد را امضا می‌کنید و کلید API و رمز خود را دریافت می‌کنید. کلیدهای جدید تا پایان گواهی‌دهی در محیط ارزیابی با ۵۰ درخواست در روز کار می‌کنند.

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

پلن‌های PHPTRAVELS از به‌صورت لایسنس یک‌باره همراه با کد منبع شروع می‌شوند. قرارداد Hotelbeds شما جداگانه است و مستقیماً با Hotelbeds توافق می‌شود. صفحه قیمت‌ها را ببینید یا از تیم فروش پیش‌فاکتور بخواهید.

بیشتر بدانید

بیشتر درباره پلتفرم