লাইভ ডেমো

হোটেল সাপ্লায়ার ইন্টিগ্রেশন

Hotelbeds API ইন্টিগ্রেশন: কনটেন্ট, ম্যাপিং ও লাইভ বুকিং

Hotelbeds API ইন্টিগ্রেশন একটি নয়, দুটি কাজ। প্রথমে আপনি হোটেল কনটেন্ট ডাউনলোড করে সংরক্ষণ করেন, তারপর লাইভ রেটে বুকিং করেন। PHPTRAVELS দুটো কাজই নিজের হোটেল মডিউলে করে, আপনার নিজস্ব Hotelbeds চুক্তি ও কি দিয়ে।

  • Content API সিঙ্ক
  • Booking API ফ্লো
  • BOOKABLE ও RECHECK রেট
  • হোটেল ম্যাপিং

Hotelbeds-এর API কীভাবে একসাথে কাজ করে

Hotelbeds API ইন্টিগ্রেশন: এক দিকে কনটেন্ট, অন্য দিকে বুকিং

Hotelbeds তার হোটেল API দুই ভাগে ভাগ করে। Content API স্থির ডেটা দেয়: বিবরণ, ছবি, সুবিধা, মিল প্ল্যান ও রুম। Booking API লাইভ প্রাপ্যতা ও দাম দেয় এবং বুকিং নেয়। মাঝখানের একটি ধাপ বেছে নিন, দেখুন সেটি কোন কল ব্যবহার করে।

Content API

স্থির, আপনার দিকে সংরক্ষিত
  • হোটেল তালিকাhotels · from=1&to=1000আপনার পোর্টফোলিওর সব হোটেল, প্রতি রিকোয়েস্টে সর্বোচ্চ 1,000 হোটেলের পেজে।
  • সুবিধা, মিল ও রুমfacilities · boards · roomsকোড টেবিল, যা Booking API-এর কোডকে অতিথিদের বোধগম্য শব্দে রূপান্তর করে।
  • ছবিphotos.hotelbeds.com/giata/ছবির আংশিক পাথ, যা আপনার দরকারি সাইজে Hotelbeds ফটো হোস্টের সাথে যুক্ত হয়।
  • দৈনিক পরিবর্তনlastUpdateTimeপ্রথম লোডের পর lastUpdateTime সহ দিনে একটি রিকোয়েস্ট শুধু পরিবর্তনগুলো ফেরত দেয়।

রিকোয়েস্ট ফ্লো

Booking API

লাইভ, প্রতি অতিথির জন্য কল
  • প্রাপ্যতাPOST /hotelsআপনার হোটেল কোড, তারিখ ও অতিথি সংখ্যার জন্য রুম, মিল, দাম ও বাতিল ফি।
  • রেট চেকPOST /checkratesRECHECK চিহ্নিত রেটের হালনাগাদ দাম ও শর্ত, সাথে আপসেলিং বিকল্প।
  • বুকিংPOST /bookingsবেছে নেওয়া rateKey বুককারী ও অতিথিদের নামসহ নিশ্চিত করে এবং রেফারেন্স ফেরত দেয়।
  • বাতিল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-এর ভাষায়, টেস্ট সার্ভার প্রোডাকশনের মতোই, তবে সেখানে বুকিং আসল নয় এবং কার্ড থেকে টাকা কাটা হয় না।
দিনে 50টি রিকোয়েস্ট
নতুন কি দিনে 50টি রিকোয়েস্টের কোটাসহ একটি ইভ্যালুয়েশন পরিবেশ খোলে। সার্টিফিকেশনের সাথে আরও কোটা আসে।
লাইভ কনটেন্ট কল নয়
Hotelbeds সতর্ক করে যে রিয়েল টাইমে Content API কল করলে ক্রেডেনশিয়াল ব্লক হতে পারে। PHPTRAVELS কখনো তা করে না।

কনটেন্ট সিঙ্ক প্ল্যানার

আপনার হোটেল তালিকার জন্য কতগুলো Content API কল লাগবে

Hotelbeds-এর ভাষায়, হোটেল তালিকা সর্বোচ্চ 1,000 হোটেলের পেজে আসে, এবং প্রথম লোডের পর lastUpdateTime সহ দৈনিক রিকোয়েস্ট শুধু পরিবর্তন ফেরত দেয়। সিঙ্কের পরিকল্পনা করতে আপনার সংখ্যাগুলো দিন।

প্রথম পূর্ণ লোডের রিকোয়েস্ট
20
প্রতি দৈনিক আপডেটের রিকোয়েস্ট
3
ইভ্যালুয়েশন কোটায় একবার লোড করতে দিন
1

শুধু আনুমানিক, হোটেল তালিকার জন্য। কোড টেবিল ও ছবি আরও কয়েকটি কল যোগ করে। দিনে 50টি রিকোয়েস্টের ইভ্যালুয়েশন কোটায় প্রথমে একটি গন্তব্য দিয়ে টেস্ট করুন।

গো-লাইভ চেকলিস্ট

লাইভে যাওয়ার আগে যা প্রস্তুত রাখবেন

Hotelbeds তার ড্যাশবোর্ডের মাধ্যমে আপনাকে ইভ্যালুয়েশন থেকে সার্টিফিকেশন এবং তারপর লাইভ কি-তে নিয়ে যায়। এগুলো সেই বিষয় যা Hotelbeds API ইন্টিগ্রেশনকে আগে কভার করতে হবে, এবং PHPTRAVELS কীভাবে সেগুলো কভার করে।

  • ইভ্যালুয়েশন কি অ্যাডমিনে যুক্ত, টেস্ট হোস্ট নির্বাচিত
  • Content API আপনার ডেটাবেসে সিঙ্ক, দৈনিক আপডেট নির্ধারিত
  • হোটেল আপনার তালিকায় ম্যাপ করা, সন্দেহজনক মিল পর্যালোচিত
  • RECHECK রেট পেমেন্টের আগে রেট চেকের মধ্য দিয়ে যায়
  • hotelMandatory-এর মান true হলে sellingRate মানা হয়
  • রেট মন্তব্য ও বাতিল ফি অতিথির পেমেন্টের আগে দেখানো হয়
  • ভাউচারে Hotelbeds রেফারেন্স ও রেট মন্তব্য দেখায়
  • বাতিল আগে সিমুলেট, তারপর নিশ্চিত, ফি রেকর্ড করা

সার্টিফিকেশনের ধাপ ও লাইভ অ্যাক্সেস Hotelbeds আপনার চুক্তি ও বাজার অনুযায়ী ঠিক করে।

খরচ

ইঞ্জিনের জন্য একটি লাইসেন্স, Hotelbeds-এর সাথে আপনার নিজস্ব চুক্তি

PHPTRAVELS সোর্স কোডসহ এককালীন লাইসেন্স। Hotelbeds আপনার ও Hotelbeds-এর মধ্যে আলাদা চুক্তি, তাই নেট রেট ও কি আপনারই থাকে।

Startup
এককালীন লাইসেন্স
এককালীন লাইসেন্স
Agency
এককালীন লাইসেন্স
এককালীন লাইসেন্স
Enterprise
এককালীন লাইসেন্স
এককালীন লাইসেন্স

Hotelbeds হলো একাধিক হোটেল উৎসের একটি, যেগুলো আপনি পাশাপাশি চালাতে পারেন। ট্রাভেল API ওভারভিউতে দেখুন এটি RateHawk-এর সাথে কীভাবে মানায়, অথবা XML সাপ্লায়ার তালিকা-এ সাপ্লায়ারদের তুলনা করুন।

দাম দেখুনহোটেল ডেমো চেষ্টা করুন

সাধারণ প্রশ্ন

Hotelbeds API ইন্টিগ্রেশন নিয়ে প্রশ্ন

Hotelbeds সংযুক্ত করার আগে ডেভেলপার ও ট্রাভেল কোম্পানিগুলো যা জিজ্ঞেস করে।

সেলসের সাথে কথা বলুন

দুটি অংশ। Content API-এর সাথে ব্যাকগ্রাউন্ড সিঙ্ক, যা হোটেল, ছবি, সুবিধা, মিল ও রুম আপনার ডেটাবেসে সংরক্ষণ করে, এবং Booking API-এর সাথে লাইভ ফ্লো, যা প্রাপ্যতা, রেট চেক, বুকিং ও বাতিল সামলায়। PHPTRAVELS দুটোই নিজের হোটেল মডিউলে চালায়।

লোকে এখনও একে Hotelbeds XML বলে, কিন্তু Hotelbeds-এর বর্তমান ডকুমেন্টেশনে JSON রিকোয়েস্ট ও রেসপন্স দেখানো হয়। যেভাবেই হোক অপারেশন একই, এবং ফরম্যাট PHPTRAVELS আপনার হয়ে সামলায়।

BOOKABLE রেট আগে থেকেই হালনাগাদ এবং সঙ্গে সঙ্গে বুক করা যায়। RECHECK রেটের জন্য আগে রেট চেক কল দরকার, যা বর্তমান দাম ও শর্ত ফেরত দেয়। PHPTRAVELS পেমেন্ট ধাপের আগে এই কলটি করে।

এটি ধীর, এবং Hotelbeds সতর্ক করে যে রিয়েল টাইমে Content API ব্যবহার করলে ক্রেডেনশিয়াল ব্লক হতে পারে। কনটেন্ট পেজে পেজে ডাউনলোড করে সংরক্ষণ এবং lastUpdateTime দিয়ে দিনে একবার আপডেট করা উচিত, PHPTRAVELS ঠিক এভাবেই কাজ করে।

হ্যাঁ। আপনি Hotelbeds-এ রেজিস্টার করেন, চুক্তি সই করেন এবং নিজস্ব API কি ও সিক্রেট পান। সার্টিফিকেশন শেষ না হওয়া পর্যন্ত নতুন কি দিনে 50টি রিকোয়েস্টের ইভ্যালুয়েশন পরিবেশে কাজ করে।

হ্যাঁ। হোটেল ম্যাপিং বিভিন্ন উৎসে একই প্রপার্টিকে যুক্ত করে, ফলে অতিথিরা সেরা উপলব্ধ রেটসহ একটি হোটেল দেখেন, আর প্রতিটি উৎস নিজের মার্কআপ ও নিয়ম রাখে।

PHPTRAVELS প্ল্যান সোর্স কোডসহ এককালীন লাইসেন্স হিসেবে থেকে শুরু। আপনার Hotelbeds চুক্তি আলাদা এবং সরাসরি Hotelbeds-এর সাথে ঠিক হয়। প্রাইসিং পেজ দেখুন বা সেলস টিমের কাছে কোটেশন চান।

আরও দেখুন

প্ল্যাটফর্ম সম্পর্কে আরও