یکپارچهسازی API هتل
یکپارچهسازی RateHawk API: از کلید API تا رزرو زنده هتل
حساب RateHawk خود را به PHPTRAVELS وصل کنید و هتل‌ها و آپارتمان‌های RateHawk را در وبسایت و پورتال نمایندگان خودتان بفروشید. اتصال آماده است: کلیدهای API را وارد کنید، پایگاه داده هتل‌ها را ایمپورت کنید، مارکآپ خود را تعیین کنید و گواهیسنجی RateHawk را پشت سر بگذارید.
- اتصال آماده RateHawk
- ETG API v3
- ایمپورت فایل هتل‌ها
- مارکآپ شما روی نرخ خالص
تأمین‌کننده
RateHawk چیست و چرا آژانس‌ها آن را وصل می‌کنند
RateHawk پلتفرم رزرو B2B گروه Emerging Travel Group (ETG) برای آژانس‌های مسافرتی، تورگردانان و شرکت‌های سفر است. شرکا هتل، آپارتمان و دیگر اقامتگاه‌ها را با نرخ خالص رزرو می‌کنند، یا در پورتال خود RateHawk یا از طریق API آن.
نام این API، ETG API است. نسخه فعلی آن v3 است، یک REST API با درخواست و پاسخ JSON که جست‌وجو، رزرو و لغو را پوشش میدهد. PHPTRAVELS یک اتصال RateHawk در ماژول اقامت ارائه میدهد، بنابراین نتایج RateHawk کنار دیگر تأمین‌کنندگان هتل و قراردادهای خود شما نمایش داده میشود.
- شرکت
- RateHawk، بخشی از Emerging Travel Group
- نوع
- پلتفرم اقامت B2B برای فعالان حرفه‌ای سفر
- موجودی
- بیش از ۲٫۶ میلیون گزینه اقامت، به گفته RateHawk
- شرکای API
- بیش از ۷۰۰ مشتری API، به گفته RateHawk در ۲۰۲۴
- API
- ETG API v3 · REST · JSON
- در PHPTRAVELS
- اتصال آماده در ماژول اقامت
فرایند رزرو ETG API v3
یک رزرو RateHawk مرحله به مرحله چگونه انجام میشود
هر رزرو RateHawk از همین پنج مرحله می‌گذرد. برای هر مرحله، فراخوانی‌های ETG API پشت آن و کاری که PHPTRAVELS برای شما انجام میدهد آمده است.
- 01
جست‌وجو
فراخوانی‌های ETG API
جست‌وجو بر اساس منطقه · بر اساس مختصات جغرافیایی · بر اساس شناسه هتل‌ها
PHPTRAVELS
بر اساس شهر، محدوده روی نقشه یا فهرست هتل‌ها، همراه با تاریخ، تعداد مهمانان و کشور اقامت مسافر جست‌وجو میکند و نرخ‌های خالص زنده را با مارکآپ شما نشان میدهد.
- 02
صفحه هتل
فراخوانی‌های ETG API
دریافت صفحه هتل
PHPTRAVELS
همه اتاق‌ها و نرخ‌های هتل انتخاب‌شده را بارگذاری میکند: برنامه غذایی، مالیات‌ها، سیاست لغو و نوع پرداخت.
- 03
پیش‌رزرو
فراخوانی‌های ETG API
پیش‌رزرو نرخ · دریافت اطلاعات نرخ
PHPTRAVELS
درست پیش از پرداخت بررسی میکند که نرخ انتخاب‌شده هنوز با همان قیمت در دسترس باشد و اگر تغییر کرده باشد، تسویه را متوقف میکند.
- 04
رزرو
فراخوانی‌های ETG API
ایجاد، شروع و بررسی فرایند رزرو
PHPTRAVELS
رزرو را ایجاد میکند، اطلاعات مهمان را می‌فرستد، وضعیت را تا تأیید دنبال میکند و شناسه سفارش RateHawk را ذخیره میکند.
- 05
پس از رزرو
فراخوانی‌های ETG API
دریافت رزروها · لغو رزرو · وبهوک‌های وضعیت
PHPTRAVELS
واچر را می‌فرستد، رزرو را در پنل مدیریت و حساب مشتری نشان میدهد و لغوها را طبق سیاست نرخ اجرا میکند.
داده‌های ثابت
پایگاه داده هتلهای RateHawk را یک بار ایمپورت کنید و سپس به‌روز نگه دارید
نتایج جست‌وجو فقط نرخ‌ها را دارند. نام‌ها، نشانی‌ها، عکس‌ها، امکانات و توضیحات از داده‌های ثابت ETG می‌آیند که PHPTRAVELS آن‌ها را در صفحات هتل شما ایمپورت میکند.
فایل مناطق
کشورها، شهرها و مناطق، تا مسافران بتوانند بر اساس مقصد جست‌وجو کنند.
فایل هتل‌ها
فایل کامل محتوای هتل‌ها: نام‌ها، نشانی‌ها، مختصات، عکس‌ها، امکانات و توضیحات.
فایل افزایشی
فقط آنچه از آخرین ایمپورت تغییر کرده، تا کاتالوگ بدون بارگذاری کامل دوباره به‌روز بماند.
فایل نظرات
امتیازها و متن نظرات مهمانان برای نمایش در صفحات هتل، در صورتی که در قرارداد شما گنجانده شده باشد.
- فایل مناطق100%
- فایل هتل‌ها100%
- فایل افزایشی64%
- فایل نظرات30%
صفحه نمونه. تعدادها به حساب و زبان‌های شما بستگی دارد.
ETG در کنار این فایل‌ها، یک Content API نیز برای دریافت داده‌های هتل در زمان نیاز ارائه میدهد.
کلید API و سندباکس
احراز هویت در RateHawk API چگونه کار میکند
ETG API از احراز هویت HTTP Basic استفاده میکند. شناسه کلید شما نام کاربری و کلید API رمز عبور است که با هر درخواست از طریق HTTPS ارسال میشوند.
1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3 -H "Content-Type: application/json" \ 4 https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5 -d '{ 6 "checkin": "2026-11-14", 7 "checkout": "2026-11-16", 8 "residency": "gb", 9 "language": "en",10 "currency": "USD",11 "guests": [{ "adults": 2, "children": [] }],12 "hids": [8473727]13 }'1415# 8473727 = the test hotel: a real booking if you book it
- دو میزبان
- سندباکس: api-sandbox.ratehawk.com. آزمایش و محیط عملیاتی: api.ratehawk.com. میزبان‌های قدیمی worldota.net منسوخ شده‌اند.
- هتل آزمایشی واقعی است
- با کلیدهای آزمایشی فقط می‌توان هتل آزمایشی با hid 8473727 را رزرو کرد و این رزرو واقعی است، با مسئولیت مالی واقعی. بلافاصله پس از آزمایش آن را لغو کنید.
- کلیدها روی سرور می‌مانند
- PHPTRAVELS شناسه کلید و کلید API را در پیکربندی سرور نگه می‌دارد، هرگز در مرورگر یا اپلیکیشن.
- کشور اقامت اهمیت دارد
- نرخ‌ها به کشور اقامت مسافر بستگی دارند، بنابراین اتصال آن را با هر جست‌وجو ارسال میکند.
راه‌اندازی در PHPTRAVELS
اتصال RateHawk را در چهار مرحله راه‌اندازی کنید
نیازی به نوشتن کد نیست: اتصال در پنل مدیریت پیکربندی میشود.
- 01کلیدهای API را اضافه کنیدشناسه کلید و کلید API دریافتی از RateHawk را وارد کنید، ابتدا برای سندباکس و بعداً برای محیط عملیاتی.
- 02پایگاه داده هتل‌ها را ایمپورت کنیدفایل‌های مناطق و هتل‌ها را بارگذاری کنید، سپس به‌روزرسانی‌های افزایشی را زمان‌بندی کنید.
- 03مارکآپ و ارز را تعیین کنیدمارک‌آپ درصدی یا ثابت، بر اساس کانال، گروه نمایندگان یا مقصد، به ارزهایی که با آن‌ها میفروشید.
- 04آزمایش کنید و فعال شویدرزرو و لغو آزمایشی را اجرا کنید، گواهیسنجی را بگذرانید و سپس به کلیدهای محیط عملیاتی بروید.
محیط
https://api-sandbox.ratehawk.comhttps://api.ratehawk.com
صفحه نمونه تنظیمات.
گواهیسنجی
از قرارداد تا دسترسی به محیط عملیاتی
RateHawk محیط عملیاتی را فقط پس از امضای قرارداد و قبولی یکپارچهسازی شما در گواهیسنجی باز میکند.
- 1
قرارداد API را امضا کنید
شمابهعنوان یک شرکت سفر با RateHawk تماس بگیرید و قرارداد API را برای بازارهای خود امضا کنید.
- 2
کلیدهای سندباکس را دریافت کنید
RateHawkRateHawk یک شناسه کلید و کلید API برای سندباکس صادر میکند.
- 3
اتصال و ایمپورت
PHPTRAVELSکلیدها در PHPTRAVELS وارد میشوند، داده‌های ثابت ایمپورت میشوند و مارک‌آپ‌ها تعیین میشوند.
- 4
گواهیسنجی را بگذرانید
RateHawkRateHawk یکپارچهسازی را بررسی میکند، از جمله فرایند رزرو، وضعیت و لغو.
- 5
دسترسی به محیط عملیاتی
شماکلیدهای محیط عملیاتی در پنل مدیریت وارد میشوند و رزروهای زنده آغاز میشوند.
پورتال، API یا موتور رزرو
سه راه برای فروش هتلهای RateHawk
نمایندگان همین امروز می‌توانند در وبسایت خود RateHawk رزرو کنند. اما API، درون موتور رزرو خودتان، است که هتلهای RateHawk را زیر برند شما قرار میدهد.
وبسایت RateHawk
- چه کسی رزرو میکند
- نمایندگان شما، هر بار یک رزرو
- برند چه کسی
- RateHawk
- چه چیزی لازم است
- ثبتنام بهعنوان نماینده و ورود
ساخت API توسط خودتان
- چه کسی رزرو میکند
- مشتریان و نمایندگان شما، بهصورت آنلاین
- برند چه کسی
- برند شما
- چه چیزی لازم است
- ماه‌ها توسعه و گواهیسنجی
PHPTRAVELS همراه با RateHawk
- چه کسی رزرو میکند
- مشتریان و نمایندگان شما، بهصورت آنلاین
- برند چه کسی
- برند شما
- چه چیزی لازم است
- پیکربندی، ایمپورت محتوا و گواهیسنجی
چند تأمین‌کننده
RateHawk در کنار دیگر تأمین‌کنندگان هتل شما
RateHawk یکی از تأمین‌کنندگان ماژول اقامت است. همان جست‌وجو می‌تواند دیگر APIهای هتل و قراردادهای خود شما را نیز در بر بگیرد، با مارکآپ و مسیریابی جداگانه برای هر تأمین‌کننده.
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
پرسش‌های متداول
پرسش‌های مربوط به یکپارچهسازی RateHawk API
آنچه آژانس‌ها پیش از اتصال RateHawk می‌پرسند.
گفتگو با فروشRateHawk هزینهای برای دسترسی به API منتشر نمیکند. شما قرارداد API را امضا میکنید و هتلهای آن را با نرخ خالص و مارکآپ خودتان میفروشید. هزینههای شما نرمافزار رزرو، میزبانی و پرداختها است.
بهعنوان یک شرکت سفر با RateHawk تماس بگیرید و قرارداد API را امضا کنید. سپس RateHawk یک شناسه کلید و کلید API برای سندباکس صادر میکند و پس از گواهیسنجی، کلیدهای محیط عملیاتی را.
مستندات ETG API بهصورت آنلاین در docs.emergingtravel.com در دسترس است، همراه با B2B API، Content API و راهنماهای سندباکس و گواهیسنجی. فایل PDF جداگانهای برای دانلود وجود ندارد؛ مستندات آنلاین نسخه فعلی هستند.
ETG API، API گروه Emerging Travel Group است، شرکتی که پشت RateHawk قرار دارد. یکپارچهسازی RateHawk API و یکپارچهسازی ETG API یک معنا دارند؛ نسخه فعلی v3 است.
PHPTRAVELS یک مجوز یکباره از $۲٬۴۹۹ با کد منبع کامل است و اتصال RateHawk در ماژول اقامت گنجانده شده است. شرایط تجاری شما با RateHawk، با خود RateHawk توافق میشود.
بله، در api-sandbox.ratehawk.com. توجه کنید که با کلیدهای آزمایشی فقط می‌توان هتل آزمایشی با hid 8473727 را رزرو کرد و این رزرو واقعی است، پس بلافاصله پس از آزمایش آن را لغو کنید.
نمایندگان برای رزرو در پورتال در ratehawk.com ثبتنام و وارد میشوند. دسترسی API جداست: از شناسه کلید و کلید API قرارداد شما استفاده میکند، نه اطلاعات ورود به پورتال.
اتصال از قبل وجود دارد، بنابراین زمان صرف قرارداد، افزودن کلیدها، ایمپورت محتوای هتل و گواهیسنجی RateHawk میشود، نه توسعه.
بله. همان اتصال هم وبسایت B2C و هم پورتال نمایندگان B2B شما را پوشش میدهد، با مارکآپ جداگانه برای هر کانال و گروه نمایندگان.
هر نرخ سیاست لغو خود را دارد که پیش از پرداخت نمایش داده میشود. لغوها از پنل مدیریت یا حساب مشتری، از طریق فراخوانی لغو رزرو و طبق همان سیاست انجام میشوند.
بیشتر بدانید
بیشتر درباره پلتفرم
- یکپارچهسازی Hotelbeds APIنرخ، رزرو و واچر Hotelbeds بهصورت زنده
- یکپارچهسازی API هتل TBOنرخ هتلهای TBO Holidays در موتور رزرو شما
- یکپارچهسازی Expedia APIهتلهای Expedia Rapid API در موتور رزرو شما
- موتور رزرو هتلرزرو مستقیم در وبسایت هتل خودتان
- هتلعمدهفروشان هتل و قراردادهای مستقیم
- پورتال سفر B2Bورود نمایندگان، قوانین قیمت، اسناد و تسویه