لائیو ڈیمو

رہائشی API

ہوٹل، اپارٹمنٹ اور ہالیڈے رینٹل کے لیے اسٹیز API

اسٹیز API ہر قسم کی رہائش آپ کی بکنگ سائٹ تک پہنچاتی ہے: ہوٹل کے کمرے، سروسڈ اپارٹمنٹ، ہالیڈے ہومز، ہاسٹل اور گیسٹ ہاؤس۔ یہ صفحہ بتاتا ہے کہ قیام کے پیچھے کون سا ڈیٹا ہوتا ہے، وہ کون سے اصول ہیں جو رینٹل کو ہوٹل سے مختلف بناتے ہیں، اور PHPTRAVELS آپ کی اپنی پراپرٹیز اور سپلائر اسٹاک کو ایک ہی سرچ میں کیسے فروخت کرتا ہے۔

  • پراپرٹی، یونٹ، ریٹ، کیلنڈر
  • کم از کم قیام اور فیسیں
  • منسوخی کی مدتیں
  • اپنا اسٹاک اور API سپلائی

ڈیٹا ماڈل

ہر قیام کے اندر چار تہیں

چاہے 300 کمروں کا ہوٹل ہو یا ساحل پر ایک گھر، رہائشی 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
  • خالی، فی رات قیمت کے ساتھ
  • پہلے سے بک
  • مالک نے بند کر رکھی
  • اس آمد سے کم از کم قیام
  • آمد کے لیے بند

مثالی ڈیٹا، آسان کیا گیا

  • قیمتیں فی رات ہوتی ہیںقیام کا کل خرچ ہر رات کا مجموعہ ہے، اس لیے ویک اینڈ ریٹ پر جمعہ اور ہفتہ دو عام دنوں سے مہنگے پڑتے ہیں۔ روزانہ اور موسمی قیمتیں کیلنڈر میں رہتی ہیں، پراپرٹی پر نہیں۔
  • کم از کم قیام کے اصولجمعہ کی آمد پر تین راتوں کی کم از کم شرط یونٹ کو دو راتوں کی سرچ سے چھپا دیتی ہے۔ رینٹل یہ اصول ہوٹلوں سے کہیں زیادہ استعمال کرتے ہیں، اکثر ویک اینڈ اور ہائی سیزن میں زیادہ سخت۔
  • آمد یا روانگی کے لیے بندایک رات لمبے قیام کے حصے کے طور پر بک ہو سکتی ہے مگر پہلی یا آخری رات کے طور پر نہیں۔ ہالیڈے ہومز میں چینج اوور ڈے اسی طرح کام کرتے ہیں۔
  • بند راتیں اور اسٹاپ سیلمالکان اپنے استعمال یا مرمت کے لیے تاریخیں بلاک کرتے ہیں، اور اسٹاپ سیل یونٹ کو فوراً فروخت سے ہٹا دیتا ہے۔ مطلوبہ تاریخوں کے اندر کوئی بھی بند رات یونٹ کو نتائج سے نکال دیتی ہے۔

ہر قیام ہوٹل نہیں ہوتا

ہوٹل، اپارٹمنٹ اور ہالیڈے رینٹل کا فرق

ڈیٹا ماڈل مشترک ہے، لیکن ہر قسم کی رہائش اسے مختلف طریقے سے بھرتی ہے۔ جب آپ ہوٹل کے کمروں سے زیادہ بیچتے ہیں تو آپ کے بکنگ فلو کو یہی فرق سنبھالنے ہوتے ہیں۔

ہوٹل

ہاسٹل اور گیسٹ ہاؤس سمیت

کیا بک ہوتا ہے
کمرے کی ایک قسم جس کے کئی ایک جیسے کمرے ہوں، یا مشترکہ ڈورمیٹری میں ایک بستر۔
قیمتیں
ہر کمرے اور کھانے کے پلان پر فی رات ریٹ؛ اضافی بالغ یا بچے اسے بدل سکتے ہیں۔
قیام کے اصول
کم از کم قیام صرف مصروف تاریخوں میں؛ زیادہ تر راتیں اکیلی بک ہو سکتی ہیں۔
فیسیں اور ڈپازٹ
سٹی یا ٹورسٹ ٹیکس، کبھی ریزورٹ فیس جو پراپرٹی پر ادا ہوتی ہے۔
آمد
24 گھنٹے یا عملے والا فرنٹ ڈیسک؛ واؤچر پر چیک اِن کے اوقات کافی ہیں۔
عام ماخذ
بیڈبینکس اور ہول سیلرز، براہ راست کنٹریکٹس، چینل مینیجرز۔

سروسڈ اپارٹمنٹ

اپارٹ ہوٹل اور شہری اپارٹمنٹ

کیا بک ہوتا ہے
یونٹ کی ایک قسم، اکثر کچن اور الگ بیڈرومز کے ساتھ۔
قیمتیں
فی یونٹ فی رات ریٹ، لمبے قیام کے لیے ہفتہ وار یا ماہانہ قیمتوں کے ساتھ۔
قیام کے اصول
کم از کم قیام عام ہے، اور لمبے قیام طلب کا بڑا حصہ ہیں۔
فیسیں اور ڈپازٹ
ہر قیام پر صفائی کی فیس اور قابل واپسی ڈپازٹ عام ہیں۔
آمد
ریسپشن کے اوقات مختلف ہوتے ہیں؛ دیر سے آمد کے لیے کی باکس یا کوڈ چاہیے۔
عام ماخذ
چینل مینیجرز، براہ راست کنٹریکٹس اور کچھ ہول سیلرز۔

ہالیڈے رینٹل

ہالیڈے ہومز، ولاز اور کیبنز

کیا بک ہوتا ہے
ایک مخصوص گھر۔ عموماً اس کا ایک ہی نمبر ہوتا ہے۔
قیمتیں
پورے گھر کا فی رات ریٹ، اور بنیادی تعداد سے زیادہ ہر مہمان پر الگ چارج۔
قیام کے اصول
کم از کم قیام، مقررہ چینج اوور ڈے اور آمد کے لیے بند تاریخیں معمول ہیں۔
فیسیں اور ڈپازٹ
صفائی کی فیس، نقصان کا قابل واپسی ڈپازٹ اور مقامی ٹیکس، ہر ایک ادائیگی سے پہلے دکھایا جاتا ہے۔
آمد
چیک اِن ہدایات، پتہ اور رابطہ آمد سے پہلے بھیجے جاتے ہیں، عوامی صفحے پر کبھی نہیں۔
عام ماخذ
مالکان اور پراپرٹی مینیجرز، براہ راست یا چینل مینیجر کے ذریعے۔

اپنے کنٹریکٹس کے بجائے بہت سے میزبانوں کے گھر بیچ رہے ہیں؟ یہ مارکیٹ پلیس ہے، جس کا ذکر BnB پورٹل صفحے پر ہے۔

منسوخی کی پالیسی کی مدتیں

ایک بکنگ، منسوخی کی تین مدتیں

منسوخی کی پالیسی آمد کی تاریخ سے پیچھے کی طرف گنی جانے والی ٹائم لائن ہے۔ ہر مدت بتاتی ہے کہ مہمان اس کے اندر منسوخ کرے تو اسے کیا واپس ملے گا۔

بکنگچیک اِن
  1. 01 · آمد سے 14 دن پہلے تکمفت منسوخیمہمان منسوخ کرتا ہے اور پوری رقم واپس ملتی ہے۔ مسافر سب سے پہلے یہی آخری تاریخ دیکھتے ہیں، اس لیے اسے اصول کی بجائے تاریخ کی شکل میں دکھائیں۔
  2. 02 · 14 سے 3 دن پہلےجزوی جرمانہجرمانہ لگتا ہے، اکثر پہلی رات یا قیام کا کچھ فیصد۔ رینٹل اس مدت میں ڈپازٹ رکھ سکتے ہیں۔
  3. 03 · آخری 3 دن اور نو شوناقابل واپسیپوری رقم رکھ لی جاتی ہے۔ ناقابل واپسی کے طور پر بکنے والے ریٹ پلانز بکنگ کے لمحے سے ہی اس مدت میں ہوتے ہیں۔
مثالی مدتیں؛ ہر ریٹ پلان کی اپنی ہوتی ہیں۔
  • ہر ریٹ پلان پر، پراپرٹی پر نہیںایک ہی اپارٹمنٹ کا لچکدار ریٹ اور سستا ناقابل واپسی ریٹ ہو سکتا ہے، اس لیے پالیسی ریٹ پلان کی پرت سے تعلق رکھتی ہے۔
  • تاریخیں پراپرٹی کے ٹائم زون میں"14 دن پہلے" آمد کی تاریخ سے اس جگہ کے حساب سے گنا جاتا ہے جہاں پراپرٹی ہے۔ اسے صفحے اور واؤچر پر واضح تاریخ اور وقت میں بدل کر دکھائیں۔
  • سپلائر کی پالیسی مقدم ہےAPI اسٹاک کے ساتھ آپ سپلائر سے نرم شرائط پیش نہیں کر سکتے۔ اپنے کنٹریکٹس کے ساتھ مدتیں آپ خود طے کرتے ہیں۔

اپنا اسٹاک اور API اسٹاک

آپ کی کنٹریکٹ شدہ پراپرٹیز اور سپلائر APIs ایک ہی سرچ میں

رہائش بیچنے والے زیادہ تر دونوں کرتے ہیں: جن جگہوں سے خود کنٹریکٹ کرتے ہیں انہیں لوڈ کرتے ہیں اور باقی کے لیے سپلائر APIs شامل کرتے ہیں۔ مسافر کو کبھی پتہ نہیں چلنا چاہیے کہ قیام کہاں سے آیا۔

آپ کی اپنی پراپرٹیز

  • ایڈمن میں پراپرٹیز، یونٹس اور ریٹ پلانز خود لوڈ کریں
  • مالکان اور ہوٹلوں کو اپنا کیلنڈر سنبھالنے کے لیے ایکسٹرانیٹ لاگ اِن دیں
  • قیمتیں، کم از کم قیام، بند تاریخیں اور منسوخی کی مدتیں طے کریں
  • ریلیز ڈیز اور اسٹاپ سیل کے ساتھ ایلوٹمنٹس
  • یا چینل مینیجر سے ریٹس اور دستیابی وصول کریں

سپلائر API اسٹاک

  • ایسی منزلوں میں بڑے کیٹلاگ جن سے آپ خود کنٹریکٹ نہیں کر سکتے
  • سرچ کے وقت لائیو قیمتیں اور دستیابی
  • ہر ریٹ پر سپلائر کے کھانے کے پلان، پالیسیاں اور فیسیں
  • آپ کے اپنے سپلائر کنٹریکٹ اور اسناد سے فعال
  • بکنگ اور منسوخی براہ راست سپلائر کو بھیجی جاتی ہے

مہمان کو کیا ملتا ہے

  • نتائج کی ایک فہرست اور ہر جگہ کا ایک پراپرٹی صفحہ
  • کئی ماخذ سے آنے والا ایک ہی کمرہ آپ کی قیمت پر ایک بار دکھایا جاتا ہے
  • سپلائر، منزل یا چینل کے لحاظ سے آپ کا مارک اپ، اور B2B ایجنٹ ریٹس
  • ایک ہی واؤچر فارمیٹ، چاہے تصدیق کسی بھی ماخذ نے کی ہو

چینل مینیجر جوڑنے کا ذکر چینل مینیجر انٹیگریشن پر ہے۔ جو کمرے آپ کنٹریکٹ کے تحت رکھتے ہیں ان کے لیے بکنگ انوینٹری سسٹم دیکھیں۔

PHPTRAVELS میں تیار

پہلے سے منسلک اسٹیز سپلائرز

یہ رہائشی سپلائرز آج Stays ماڈیول سے منسلک ہیں۔ آپ سپلائر کے ساتھ معاہدہ کرتے ہیں، ایڈمن میں اپنی اسناد درج کرتے ہیں، ان کے سینڈ باکس میں ٹیسٹ کرتے ہیں اور لائیو ہو جاتے ہیں۔ فہرست ہماری انٹیگریشنز ڈائریکٹری سے لائیو آتی ہے۔

ایسا سپلائر چاہیے جو فہرست میں نہیں، جیسے کوئی علاقائی رینٹل نیٹ ورک؟ دستاویزات والی کوئی بھی رہائشی API شامل کی جا سکتی ہے، دیکھیں کسٹم API انٹیگریشن۔ ہوٹل سپلائر کی اقسام اور کنٹینٹ میپنگ کے لیے ہوٹلز API صفحہ پڑھیں، اور دو سب سے بڑے بیڈبینک گائیڈز: RateHawk API انٹیگریشن اور Hotelbeds API انٹیگریشن۔

قیام ویسے بک کریں جیسے آپ کے مہمان کریں گے

لائیو ڈیمو میں سرچ کریں، ریٹس کا موازنہ کریں اور بک کریں، پھر ہمیں بتائیں کہ آپ کون سی پراپرٹیز اور سپلائرز بیچنا چاہتے ہیں۔

اپنی ایپ یا پارٹنر فیڈ بنا رہے ہیں؟ PHPTRAVELS REST API تمام منسلک اسٹیز ماخذ ایک ہی فارمیٹ میں فراہم کرتی ہے، بکنگ ایونٹس کے لیے ویب ہکس کے ساتھ۔ یہ Enterprise پلان کے ساتھ آتی ہے، دیکھیں قیمتیں اور ڈیولپر دستاویزات۔ وسیع تر تصویر ٹریول API پر ہے۔

عام سوالات

اسٹیز API: ڈیولپرز اور ایجنسیوں کے سوالات

سیلز سے بات کریں

اسٹیز API ویب سروسز کا ایک سیٹ ہے جو بکنگ سائٹ کو رہائش تلاش کرنے، مخصوص تاریخوں اور مہمانوں کے لیے قیمتیں اور دستیابی پڑھنے، اور بکنگز بنانے، دیکھنے اور منسوخ کرنے دیتا ہے۔ یہ ہوٹلوں اور رہائش کی ہر دوسری قسم کا احاطہ کرتی ہے: اپارٹمنٹ، ہالیڈے رینٹل، ہاسٹل اور گیسٹ ہاؤس۔

بنیادی کالز ایک جیسی ہیں۔ اسٹیز API کو وہ بھی سنبھالنا ہوتا ہے جو غیر ہوٹل رہائش کو چاہیے: پوری یونٹ کی بکنگ، کم از کم قیام اور چینج اوور ڈے، اضافی مہمان کے چارجز، صفائی کی فیس، قابل واپسی ڈپازٹ اور آمد سے پہلے بھیجی جانے والی چیک اِن ہدایات۔

جی ہاں۔ PHPTRAVELS میں Stays ماڈیول ہر قسم کی رہائش کے لیے پراپرٹی، یونٹ، ریٹ پلان اور دستیابی کا ایک ہی ماڈل استعمال کرتا ہے، اس لیے ہوٹل، اپارٹمنٹ اور ہالیڈے ہومز اپنے اپنے اصولوں کے ساتھ ایک ہی سرچ میں آتے ہیں۔

کیلنڈر کی ہر رات پر کم از کم قیام کی مدت ہو سکتی ہے، جو عموماً آمد کی تاریخ سے جڑی ہوتی ہے۔ اگر مہمان کم از کم سے کم راتیں تلاش کرے تو یونٹ واپس نہیں آتا۔ آمد کے لیے بند اور روانگی کے لیے بند کے فلیگ چینج اوور ڈیز کے لیے اسی طرح کام کرتے ہیں۔

جی ہاں۔ آپ پراپرٹیز، یونٹس، ریٹ پلانز اور کیلنڈرز خود شامل کر سکتے ہیں، مالکان کو ایکسٹرانیٹ لاگ اِن دے سکتے ہیں، یا چینل مینیجر سے ریٹس لے سکتے ہیں، اور انہیں سپلائر اسٹاک کے ساتھ ایک ہی نتائج کی فہرست میں بیچ سکتے ہیں۔

ریٹ پلان سے۔ سپلائر اسٹاک سپلائر کی پالیسی کے ساتھ آتا ہے، اور آپ کی اپنی پراپرٹیز وہ مدتیں استعمال کرتی ہیں جو آپ طے کرتے ہیں۔ آخری تاریخ مہمان کو ادائیگی سے پہلے دکھائی جاتی ہے اور واؤچر پر چھپتی ہے۔

نہیں۔ آپ ہر رہائشی سپلائر کے ساتھ خود معاہدہ کرتے ہیں اور ایڈمن میں اپنی اسناد درج کرتے ہیں۔ PHPTRAVELS بکنگ پلیٹ فارم، Stays ماڈیول اور تیار کنیکٹرز فراہم کرتا ہے۔

جی ہاں۔ Enterprise پلان پر PHPTRAVELS REST API تمام منسلک ماخذ پر سرچ اور بکنگ ایک ہی فارمیٹ میں فراہم کرتی ہے، بکنگ ایونٹس کے لیے ویب ہکس اور توسیع کے لیے مکمل سورس کوڈ کے ساتھ۔

PHPTRAVELS لائسنس، آپ کا اپنا ڈومین اور اسٹاک کا کم از کم ایک ماخذ: خود کنٹریکٹ کی ہوئی پراپرٹیز، چینل مینیجر، یا رہائش کے ہول سیلر سے سپلائر کنٹریکٹ۔ لائیو ڈیمو پہلے پورا فلو دکھاتا ہے۔