লাইভ ডেমো

আবাসন API

হোটেল, অ্যাপার্টমেন্ট ও ভ্যাকেশন রেন্টালের জন্য স্টেজ API

স্টেজ API সব ধরনের আবাসন আপনার বুকিং সাইটে নিয়ে আসে: হোটেল রুম, সার্ভিসড অ্যাপার্টমেন্ট, হলিডে হোম, হোস্টেল ও গেস্টহাউস। এই পৃষ্ঠায় বোঝানো হয়েছে একটি থাকার পেছনের ডেটা, কোন নিয়ম রেন্টালকে হোটেল থেকে আলাদা করে, এবং PHPTRAVELS কীভাবে আপনার নিজস্ব প্রপার্টি ও সাপ্লায়ারের স্টক একই সার্চে বিক্রি করে।

  • প্রপার্টি, ইউনিট, রেট, ক্যালেন্ডার
  • ন্যূনতম থাকা ও ফি
  • বাতিলের সময়সীমা
  • নিজস্ব স্টক ও API সাপ্লাই

ডেটা মডেল

প্রতিটি থাকার ভেতরে চারটি স্তর

৩০০ রুমের হোটেল হোক বা একটিমাত্র সমুদ্রতীরের বাড়ি, আবাসন API সেটিকে একই চারটি নেস্টেড স্তরে বর্ণনা করে। প্রতিটি স্তর বুকিংয়ের আগে অতিথির আলাদা একটি প্রশ্নের উত্তর দেয়।

01প্রপার্টি

জায়গাটি নিজেই: নাম, ধরন, ঠিকানা ও মানচিত্রে অবস্থান, ছবি, সুবিধা, স্টার বা মানের রেটিং, বাড়ির নিয়ম ও চেক-ইনের সময়।

property_id · type · address · geo · photos · amenities · check_in_from

02রুম বা ইউনিট

যা আসলে বুক হয়: একটি রুমের ধরন, পুরো অ্যাপার্টমেন্ট বা শেয়ার্ড ডরমে একটি বিছানা, সঙ্গে আকার, বিছানা ও সর্বোচ্চ ধারণক্ষমতা।

unit_id · beds · size_m2 · max_adults · max_children

03রেট প্ল্যান

ইউনিটটি কীভাবে বিক্রি হয়: খাবারের ব্যবস্থা, বাতিলের নীতি, পেমেন্টের শর্ত এবং কারা বুক করতে পারবে, যেমন সবাই বা শুধু এজেন্ট।

rate_plan_id · board · cancel_policy · payment · channel

04প্রাপ্যতা

প্রতি রাতে একটি সারি: দাম, বাকি ইউনিট, ন্যূনতম থাকা এবং ওই দিন আগমন বা প্রস্থান অনুমোদিত কি না।

date · price · units_left · min_stay · closed_to_arrival

একটি আবাসন লিস্টিংয়ের আলাদা আলাদা স্তূপ করা স্তর হিসেবে আঁকা একটি ভবন, একটি রুম, একটি দামের ট্যাগ ও একটি ক্যালেন্ডার

PHPTRAVELS তার আবাসন মডিউলের নাম দিয়েছে Stays, কারণ একই মডেল হোটেলের চেয়ে অনেক বেশি কিছু কভার করে। একটি প্রপার্টিতে থাকে ইউনিট, একটি ইউনিট এক বা একাধিক রেট প্ল্যানে বিক্রি হয়, আর প্রতিটি রেট প্ল্যানের আছে দাম ও প্রাপ্যতার রাত-ভিত্তিক ক্যালেন্ডার। এই চার স্তর ঠিক থাকলে হোস্টেলের একটি বিছানা, হোটেল সুইট ও তিন বেডরুমের ভিলা একই সার্চ ও চেকআউটে খাপ খায়।

সাপ্লায়াররা স্তরগুলোর নাম আলাদা দেন, কেউ কেউ দুটি স্তর মিলিয়ে ফেলেন, কিন্তু কাঠামোটি সবসময় থাকে। হোটেল প্রতিটি সোর্সকে এর সঙ্গে মিলিয়ে দেয়, ফলে অতিথি একটি সামঞ্জস্যপূর্ণ পৃষ্ঠা দেখেন।

রাতের পর রাত

প্রাপ্যতার ক্যালেন্ডারেই থাকা বুকিং জেতা বা হারা হয়

প্রতিটি স্টেজ API শেষ হয় একটি ক্যালেন্ডারে। চাওয়া থাকার প্রতিটি রাত খালি, দামযুক্ত এবং থাকার নিয়মে অনুমোদিত হলেই সার্চ একটি প্রপার্টি ফেরত দেয়।

দুই বেডরুমের অ্যাপার্টমেন্ট · স্ট্যান্ডার্ড রেটনভেম্বর 2026 · প্রতি রাতের দাম
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • খালি, প্রতি রাতের দামসহ
  • আগেই বুক করা
  • মালিক বন্ধ রেখেছেন
  • এই আগমন থেকে ন্যূনতম থাকা
  • আগমনের জন্য বন্ধ

উদাহরণ ডেটা, সরলীকৃত

  • দাম প্রতি রাতেথাকার মোট খরচ প্রতিটি রাতের যোগফল, তাই সপ্তাহান্তের রেটে শুক্র ও শনি দুটি সাধারণ দিনের চেয়ে বেশি পড়ে। দৈনিক ও মৌসুমি দাম ক্যালেন্ডারে থাকে, প্রপার্টিতে নয়।
  • ন্যূনতম থাকার নিয়মশুক্রবার আগমনে তিন রাতের ন্যূনতম শর্ত দুই রাতের সার্চ থেকে ইউনিটটি লুকিয়ে দেয়। রেন্টাল এসব নিয়ম হোটেলের চেয়ে অনেক বেশি ব্যবহার করে, প্রায়ই সপ্তাহান্ত ও ব্যস্ত মৌসুমে আরও কড়াভাবে।
  • আগমন বা প্রস্থানের জন্য বন্ধএকটি রাত দীর্ঘ থাকার অংশ হিসেবে বুক করা যেতে পারে, কিন্তু প্রথম বা শেষ রাত হিসেবে নয়। হলিডে হোমের চেঞ্জওভার ডে এভাবেই কাজ করে।
  • বন্ধ রাত ও স্টপ-সেলমালিকরা নিজের ব্যবহার বা রক্ষণাবেক্ষণের জন্য তারিখ ব্লক করেন, আর স্টপ-সেল ইউনিটকে তৎক্ষণাৎ বিক্রি থেকে সরিয়ে দেয়। চাওয়া তারিখের মধ্যে যেকোনো বন্ধ রাত ইউনিটটিকে ফলাফল থেকে বাদ দেয়।

সব আবাসন হোটেল নয়

হোটেল বনাম অ্যাপার্টমেন্ট বনাম ভ্যাকেশন রেন্টাল

ডেটা মডেল একই, কিন্তু প্রতিটি ধরনের আবাসন এটি আলাদাভাবে পূরণ করে। হোটেল রুমের বাইরেও বিক্রি করলে আপনার বুকিং ফ্লোকে এই পার্থক্যগুলো সামলাতে হয়।

হোটেল

হোস্টেল ও গেস্টহাউসসহ

কী বুক হয়
একটি রুমের ধরন, যার অনেক অভিন্ন রুম থাকে, অথবা শেয়ার্ড ডরমে একটি বিছানা।
দাম নির্ধারণ
প্রতি রুম ও খাবারের ব্যবস্থা অনুযায়ী রাতপ্রতি রেট; বাড়তি প্রাপ্তবয়স্ক বা শিশু হলে বদলাতে পারে।
থাকার নিয়ম
ন্যূনতম থাকা শুধু ব্যস্ত তারিখে; বেশিরভাগ রাত এককভাবে বুক করা যায়।
ফি ও ডিপোজিট
সিটি বা ট্যুরিস্ট ট্যাক্স, কখনো প্রপার্টিতে দেয় রিসোর্ট ফি।
আগমন
২৪ ঘণ্টার বা কর্মীসহ ফ্রন্ট ডেস্ক; ভাউচারে চেক-ইনের সময়ই যথেষ্ট।
সাধারণ সোর্স
বেডব্যাংক ও হোলসেলার, সরাসরি চুক্তি, চ্যানেল ম্যানেজার।

সার্ভিসড অ্যাপার্টমেন্ট

অ্যাপার্টহোটেল ও শহরের অ্যাপার্টমেন্ট

কী বুক হয়
একটি ইউনিটের ধরন, প্রায়ই রান্নাঘর ও আলাদা বেডরুমসহ।
দাম নির্ধারণ
প্রতি ইউনিটে রাতপ্রতি রেট, দীর্ঘ থাকার জন্য সাপ্তাহিক বা মাসিক দামসহ।
থাকার নিয়ম
ন্যূনতম থাকা সাধারণ, আর দীর্ঘ থাকা চাহিদার বড় অংশ।
ফি ও ডিপোজিট
প্রতি থাকায় পরিষ্কারের ফি ও ফেরতযোগ্য ডিপোজিট সাধারণ।
আগমন
রিসেপশনের সময় ভিন্ন হয়; দেরিতে পৌঁছালে কি বক্স বা কোড লাগে।
সাধারণ সোর্স
চ্যানেল ম্যানেজার, সরাসরি চুক্তি ও কিছু হোলসেলার।

ভ্যাকেশন রেন্টাল

হলিডে হোম, ভিলা ও কেবিন

কী বুক হয়
একটি নির্দিষ্ট বাড়ি। সাধারণত এর একটিই থাকে।
দাম নির্ধারণ
পুরো বাড়ির রাতপ্রতি রেট, সঙ্গে মূল সংখ্যার বেশি প্রতি অতিরিক্ত অতিথির জন্য আলাদা চার্জ।
থাকার নিয়ম
ন্যূনতম থাকা, নির্দিষ্ট চেঞ্জওভার ডে এবং আগমনের জন্য বন্ধ তারিখই রীতি।
ফি ও ডিপোজিট
পরিষ্কারের ফি, ক্ষতির ফেরতযোগ্য ডিপোজিট ও স্থানীয় কর, প্রতিটি পেমেন্টের আগে দেখানো হয়।
আগমন
চেক-ইনের নির্দেশনা, ঠিকানা ও যোগাযোগ আগমনের আগে পাঠানো হয়, পাবলিক পৃষ্ঠায় কখনোই নয়।
সাধারণ সোর্স
মালিক ও প্রপার্টি ম্যানেজার, সরাসরি বা চ্যানেল ম্যানেজারের মাধ্যমে।

নিজের চুক্তির বদলে অনেক হোস্টের বাড়ি বিক্রি করছেন? সেটি একটি মার্কেটপ্লেস, যা BnB পোর্টাল পৃষ্ঠায় আছে।

বাতিলের নীতির সময়সীমা

একটি বুকিং, বাতিলের তিনটি সময়সীমা

বাতিলের নীতি হলো আগমনের তারিখ থেকে পেছনে গোনা একটি টাইমলাইন। প্রতিটি সময়সীমা বলে দেয়, তার মধ্যে বাতিল করলে অতিথি কী ফেরত পাবেন।

বুকিংচেক-ইন
  1. 01 · আগমনের ১৪ দিন আগে পর্যন্তবিনামূল্যে বাতিলঅতিথি বাতিল করলে পুরো টাকা ফেরত পান। ভ্রমণকারীরা প্রথমে এই সময়সীমাই খোঁজেন, তাই এটি নিয়ম নয়, তারিখ হিসেবে দেখান।
  2. 02 · ১৪ থেকে ৩ দিন আগেআংশিক জরিমানাজরিমানা প্রযোজ্য হয়, প্রায়ই প্রথম রাত বা থাকার একটি শতাংশ। এই সময়সীমায় রেন্টাল ডিপোজিট রেখে দিতে পারে।
  3. 03 · শেষ ৩ দিন ও নো-শোফেরতযোগ্য নয়পুরো টাকা রেখে দেওয়া হয়। ফেরতযোগ্য নয় হিসেবে বিক্রি হওয়া রেট প্ল্যান বুকিংয়ের মুহূর্ত থেকেই এই সময়সীমায় থাকে।
উদাহরণ সময়সীমা; প্রতিটি রেট প্ল্যানের নিজস্ব থাকে।
  • রেট প্ল্যান অনুযায়ী, প্রপার্টি অনুযায়ী নয়একই অ্যাপার্টমেন্টের একটি নমনীয় রেট ও একটি সস্তা ফেরতযোগ্য নয় এমন রেট থাকতে পারে, তাই নীতিটি রেট প্ল্যান স্তরের।
  • প্রপার্টির টাইম জোনে তারিখ"১৪ দিন আগে" গোনা হয় প্রপার্টির স্থানে আগমনের তারিখ থেকে। পৃষ্ঠা ও ভাউচারে এটিকে স্পষ্ট তারিখ ও সময়ে রূপান্তর করুন।
  • সাপ্লায়ারের নীতিই চূড়ান্তAPI স্টকের ক্ষেত্রে সাপ্লায়ারের চেয়ে নরম শর্ত দেওয়া যায় না। নিজের চুক্তিতে সময়সীমা আপনি নিজেই ঠিক করেন।

নিজস্ব স্টক ও API স্টক

আপনার চুক্তিবদ্ধ প্রপার্টি ও সাপ্লায়ার API এক সার্চে

বেশিরভাগ আবাসন বিক্রেতা দুটোই করেন: নিজে চুক্তি করা জায়গাগুলো লোড করেন আর বাকিটার জন্য সাপ্লায়ার API যোগ করেন। ভ্রমণকারীর কখনোই বোঝার কথা নয় থাকাটি কোথা থেকে এসেছে।

আপনার নিজস্ব প্রপার্টি

  • অ্যাডমিনে প্রপার্টি, ইউনিট ও রেট প্ল্যান নিজে লোড করুন
  • মালিক ও হোটেলকে ক্যালেন্ডার সামলাতে এক্সট্রানেট লগইন দিন
  • দাম, ন্যূনতম থাকা, বন্ধ তারিখ ও বাতিলের সময়সীমা ঠিক করুন
  • রিলিজ ডে ও স্টপ-সেলসহ অ্যালটমেন্ট
  • অথবা চ্যানেল ম্যানেজার থেকে রেট ও প্রাপ্যতা নিন

সাপ্লায়ার API স্টক

  • এমন গন্তব্যে বিশাল ক্যাটালগ, যেখানে আপনি কখনো নিজে চুক্তি করতে পারতেন না
  • সার্চের সময় লাইভ দাম ও প্রাপ্যতা
  • প্রতিটি রেটে সাপ্লায়ারের খাবারের ব্যবস্থা, নীতি ও ফি
  • আপনার নিজের সাপ্লায়ার চুক্তি ও ক্রেডেনশিয়াল দিয়ে চালু
  • বুকিং ও বাতিল সরাসরি সাপ্লায়ারের কাছে যায়

অতিথি যা পান

  • একটি ফলাফল তালিকা, প্রতিটি জায়গার জন্য একটি প্রপার্টি পৃষ্ঠা
  • একাধিক সোর্সের একই রুম আপনার দামে একবারই দেখানো হয়
  • সাপ্লায়ার, গন্তব্য বা চ্যানেল অনুযায়ী আপনার মার্কআপ এবং B2B এজেন্ট রেট
  • একই ভাউচার ফরম্যাট, যে সোর্সই নিশ্চিত করুক

চ্যানেল ম্যানেজার যুক্ত করার বিষয়ে চ্যানেল ম্যানেজার ইন্টিগ্রেশন পৃষ্ঠায় আছে। চুক্তিতে ধরে রাখা রুমের জন্য দেখুন বুকিং ইনভেন্টরি সিস্টেম।

PHPTRAVELS-এ প্রস্তুত

ইতিমধ্যে যুক্ত স্টেজ সাপ্লায়ার

এই আবাসন সাপ্লায়ারগুলো আজই Stays মডিউলের সঙ্গে যুক্ত। আপনি সাপ্লায়ারের সঙ্গে চুক্তি করেন, অ্যাডমিনে নিজের ক্রেডেনশিয়াল দেন, তাদের স্যান্ডবক্সে টেস্ট করেন এবং লাইভ হন। তালিকাটি আমাদের ইন্টিগ্রেশন ডিরেক্টরি থেকে লাইভ আসে।

তালিকায় নেই এমন সাপ্লায়ার দরকার, যেমন আঞ্চলিক রেন্টাল নেটওয়ার্ক? ডকুমেন্টেশন আছে এমন যেকোনো আবাসন API যোগ করা যায়, দেখুন কাস্টম API ইন্টিগ্রেশন। হোটেল সাপ্লায়ারের ধরন ও কনটেন্ট ম্যাপিংয়ের জন্য পড়ুন হোটেল API পৃষ্ঠা, এবং দুটি সবচেয়ে বড় বেডব্যাংক গাইড: RateHawk API ইন্টিগ্রেশন ও Hotelbeds API ইন্টিগ্রেশন।

আপনার অতিথিরা যেভাবে করবেন, সেভাবে থাকা বুক করুন

লাইভ ডেমোতে সার্চ করুন, রেট তুলনা করুন ও বুক করুন, তারপর জানান কোন প্রপার্টি ও সাপ্লায়ার বিক্রি করতে চান।

লাইভ ডেমো দেখুনআপনার সাপ্লায়ার নিয়ে জিজ্ঞাসা করুন

নিজের অ্যাপ বা পার্টনার ফিড বানাচ্ছেন? PHPTRAVELS REST API যুক্ত সব Stays সোর্স একই ফরম্যাটে দেয়, বুকিং ইভেন্টের জন্য ওয়েবহুকসহ। এটি Enterprise প্ল্যানের সঙ্গে আসে, দেখুন মূল্য ও ডেভেলপার ডকুমেন্টেশন। বড় ছবিটি আছে ট্রাভেল API পৃষ্ঠায়।

FAQ

স্টেজ API: ডেভেলপার ও এজেন্সির প্রশ্ন

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

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

মূল কলগুলো একই। স্টেজ API-কে আরও সামলাতে হয় হোটেল-ভিন্ন আবাসনের চাহিদা: পুরো ইউনিট বুকিং, ন্যূনতম থাকা ও চেঞ্জওভার ডে, অতিরিক্ত অতিথির চার্জ, পরিষ্কারের ফি, ফেরতযোগ্য ডিপোজিট এবং আগমনের আগে পাঠানো চেক-ইন নির্দেশনা।

হ্যাঁ। PHPTRAVELS-এ Stays মডিউল সব ধরনের আবাসনের জন্য প্রপার্টি, ইউনিট, রেট প্ল্যান ও প্রাপ্যতার একটি মডেল ব্যবহার করে, তাই হোটেল, অ্যাপার্টমেন্ট ও হলিডে হোম নিজ নিজ নিয়মসহ একই সার্চে আসে।

ক্যালেন্ডারের প্রতিটি রাতে ন্যূনতম থাকার দৈর্ঘ্য থাকতে পারে, সাধারণত আগমনের তারিখের সঙ্গে যুক্ত। অতিথি ন্যূনতমের চেয়ে কম রাত সার্চ করলে ইউনিট ফেরত আসে না। আগমনের জন্য বন্ধ ও প্রস্থানের জন্য বন্ধ ফ্ল্যাগ চেঞ্জওভার ডে-র জন্য একইভাবে কাজ করে।

হ্যাঁ। আপনি নিজে প্রপার্টি, ইউনিট, রেট প্ল্যান ও ক্যালেন্ডার যোগ করতে পারেন, মালিকদের এক্সট্রানেট লগইন দিতে পারেন বা চ্যানেল ম্যানেজার থেকে রেট নিতে পারেন, এবং সাপ্লায়ার স্টকের পাশে একই ফলাফল তালিকায় বিক্রি করতে পারেন।

রেট প্ল্যান থেকে। সাপ্লায়ার স্টকে সাপ্লায়ারের নীতি থাকে, আর আপনার নিজস্ব প্রপার্টি আপনার ঠিক করা সময়সীমা ব্যবহার করে। সময়সীমা পেমেন্টের আগে অতিথিকে দেখানো হয় এবং ভাউচারে ছাপা হয়।

না। প্রতিটি আবাসন সাপ্লায়ারের সঙ্গে আপনি নিজে চুক্তি করেন এবং অ্যাডমিনে নিজের ক্রেডেনশিয়াল দেন। PHPTRAVELS দেয় বুকিং প্ল্যাটফর্ম, Stays মডিউল ও তৈরি কানেক্টর।

হ্যাঁ। Enterprise প্ল্যানে PHPTRAVELS REST API যুক্ত সব সোর্সে সার্চ ও বুকিং একই ফরম্যাটে দেয়, বুকিং ইভেন্টের জন্য ওয়েবহুক এবং বাড়ানোর জন্য পূর্ণ সোর্স কোডসহ।

একটি PHPTRAVELS লাইসেন্স, আপনার নিজের ডোমেইন এবং অন্তত একটি স্টকের সোর্স: নিজে চুক্তি করা প্রপার্টি, চ্যানেল ম্যানেজার, বা আবাসন হোলসেলারের সঙ্গে সাপ্লায়ার চুক্তি। লাইভ ডেমো আগে পুরো ফ্লো দেখায়।

আরও দেখুন

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