گائیڈ
API انٹیگریشن کیا ہے، ٹریول کاروباروں کے لیے وضاحت
API انٹیگریشن ایک ایسا کنکشن ہے جس کے ذریعے دو سافٹ ویئر سسٹم کسی کے دوبارہ ٹائپ کیے بغیر ڈیٹا کا تبادلہ کرتے اور عمل شروع کرتے ہیں۔ یہ گائیڈ ایک ہوٹل بکنگ کی مثال سے بتاتی ہے کہ یہ کیسے کام کرتا ہے، جو مسافر، بکنگ پلیٹ فارم، سپلائر API اور پیمنٹ گیٹ وے کے درمیان سفر کرتی ہے۔
- ایک ریکوئسٹ، ایک رسپانس
- REST، XML، SOAP اور ویب ہکس
- چار سسٹمز میں ٹریس ہوتی ایک بکنگ
- انٹیگریشنز کی ٹیسٹنگ کیسے ہوتی ہے
تعریف
API انٹیگریشن کیا ہے، آسان زبان میں
API کا مطلب ہے ایپلیکیشن پروگرامنگ انٹرفیس: قواعد کا وہ مجموعہ جو کوئی سسٹم شائع کرتا ہے تاکہ دوسرا سافٹ ویئر اس سے بات کر سکے۔ API انٹیگریشن وہ کام ہے جس میں آپ کے پلیٹ فارم کو ایسے کسی انٹرفیس سے جوڑا جاتا ہے تاکہ ڈیٹا خود بخود چلے اور عمل خود بخود ہوں۔
ٹریول میں یہ پلیٹ فارم عموماً ٹریول بکنگ سافٹ ویئر جیسا بکنگ سسٹم ہوتا ہے، اور انٹرفیس کسی سپلائر، پیمنٹ گیٹ وے یا کاروباری ٹول کا ہوتا ہے۔ ہمارا ٹریول API انٹیگریشن صفحہ بتاتا ہے کہ PHPTRAVELS یہ کنکشن کیسے فراہم کرتا ہے، اور تمام انٹیگریشنز میں پہلے سے جڑے سپلائرز درج ہیں۔
ڈیٹا کا تبادلہ
ریٹس، دستیابی، کسٹمر کی تفصیلات اور اسٹیٹس اپڈیٹس منظم فارمیٹ میں سسٹمز کے درمیان منتقل ہوتی ہیں۔
عمل خودکار بنائیں
سرچ، بکنگ، ادائیگی، منسوخی اور ملاپ ریکوئسٹس کے طور پر ہوتے ہیں، ایسے مراحل کے طور پر نہیں جنہیں کوئی ہاتھ سے دہرائے۔
نتائج کی ٹریکنگ
ہر کال کے ساتھ ایک ریفرنس ہوتا ہے، اس لیے ناکام بکنگ کو اس ریکوئسٹ تک ٹریس کیا جا سکتا ہے جس نے اسے پیدا کیا۔
ریکوئسٹ
POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{ "city": "DXB", "check_in": "2026-11-12", "check_out": "2026-11-14", "guests": 2, "currency": "USD"}رسپانس
HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{ "hotel": "Palm Marina Hotel", "room": "Deluxe, 2 adults", "rate": { "amount": 438.00, "currency": "USD" }, "refundable": true, "rate_key": "rk_19d2c7"}ایک API کال کی ساخت
- 1
اینڈ پوائنٹ اور میتھڈ
آپریشن کا پتہ اور اس پر استعمال ہونے والا فعل: availability پر POST کا مطلب ہے کمرے تلاش کرو۔
- 2
تصدیق
کلید، ٹوکن یا دستخط ثابت کرتا ہے کہ کون کال کر رہا ہے۔ سپلائرز سینڈ باکس اور پروڈکشن کے لیے الگ الگ کریڈینشلز جاری کرتے ہیں۔
- 3
پے لوڈ
منظم ان پٹ: شہر، تاریخیں، مہمان اور کرنسی۔ سپلائر کی دستاویزات ہر فیلڈ کی وضاحت کرتی ہیں۔
- 4
اسٹیٹس کوڈ
ایک نمبر جو بتاتا ہے کال کیسی رہی: 200 کامیابی، 4xx ریکوئسٹ میں مسئلہ، 5xx سپلائر کی طرف مسئلہ۔
- 5
ریکوئسٹ ID
ایک شناخت کنندہ جو دونوں فریق رکھتے ہیں۔ جب سپورٹ پوچھتی ہے کہ کسی بکنگ کا کیا ہوا، تو یہی تلاش کیا جاتا ہے۔
- 6
رسپانس باڈی
سپلائر کے فارمیٹ میں جواب، جسے آپ کا پلیٹ فارم اپنے کمروں، ریٹس اور پالیسیوں میں میپ کرتا ہے۔
ایک بکنگ، چار سسٹم
ہوٹل بکنگ کے دوران API انٹیگریشن کیا کرتا ہے
دو راتوں کے قیام کو سرچ سے واؤچر تک فالو کریں۔ ہر تیر ایک API کال ہے؛ مسافر صرف پہلی اور آخری دیکھتا ہے۔
- 01دبئی میں ہوٹل تلاش کرتا ہے، دو راتیں، دو مہماناز: مسافر, تا: بکنگ پلیٹ فارم
- 02تاریخوں، مہمانوں اور کرنسی کے ساتھ دستیابی کی ریکوئسٹاز: بکنگ پلیٹ فارم, تا: سپلائر API
- 03کمرے، ریٹس، پالیسیاں اور ایک ریٹ کیاز: سپلائر API, تا: بکنگ پلیٹ فارم
- 04آپ کے مارک اپ اور کرنسی کے ساتھ نتائج دکھائے گئےاز: بکنگ پلیٹ فارم, تا: مسافر
- 05ادائیگی سے پہلے منتخب ریٹ کی پر قیمت کی دوبارہ جانچاز: بکنگ پلیٹ فارم, تا: سپلائر API
- 06کل رقم کے لیے ادائیگی کی اتھارائزیشناز: بکنگ پلیٹ فارم, تا: پیمنٹ گیٹ وے
- 07اتھارائزڈ، دستخط شدہ ویب ہک موصولاز: پیمنٹ گیٹ وے, تا: بکنگ پلیٹ فارم
- 08مہمان کی تفصیلات کے ساتھ بکنگ ریکوئسٹاز: بکنگ پلیٹ فارم, تا: سپلائر API
- 09کنفرمیشن نمبر اور منسوخی کی شرائطاز: سپلائر API, تا: بکنگ پلیٹ فارم
- 10واؤچر، انوائس اور بکنگ ریفرنساز: بکنگ پلیٹ فارم, تا: مسافر
- 01مسافربکنگ پلیٹ فارمدبئی میں ہوٹل تلاش کرتا ہے، دو راتیں، دو مہمان
- 02بکنگ پلیٹ فارمسپلائر APIتاریخوں، مہمانوں اور کرنسی کے ساتھ دستیابی کی ریکوئسٹ
- 03سپلائر APIبکنگ پلیٹ فارمکمرے، ریٹس، پالیسیاں اور ایک ریٹ کی
- 04بکنگ پلیٹ فارممسافرآپ کے مارک اپ اور کرنسی کے ساتھ نتائج دکھائے گئے
- 05بکنگ پلیٹ فارمسپلائر APIادائیگی سے پہلے منتخب ریٹ کی پر قیمت کی دوبارہ جانچ
- 06بکنگ پلیٹ فارمپیمنٹ گیٹ وےکل رقم کے لیے ادائیگی کی اتھارائزیشن
- 07پیمنٹ گیٹ وےبکنگ پلیٹ فارماتھارائزڈ، دستخط شدہ ویب ہک موصول
- 08بکنگ پلیٹ فارمسپلائر APIمہمان کی تفصیلات کے ساتھ بکنگ ریکوئسٹ
- 09سپلائر APIبکنگ پلیٹ فارمکنفرمیشن نمبر اور منسوخی کی شرائط
- 10بکنگ پلیٹ فارممسافرواؤچر، انوائس اور بکنگ ریفرنس
درمیان کا پلیٹ فارم ہی وہ جگہ ہے جہاں API انٹیگریشن رہتا ہے: یہ مسافر کی اسکرین اور ہر سپلائر کے فارمیٹ کے درمیان ترجمہ کرتا ہے، اور ہر ریفرنس محفوظ رکھتا ہے۔
یہی ترتیب GDS کے ساتھ فلائٹ بکنگ سافٹ ویئر، ایکٹیویٹی سپلائر کے ساتھ ٹور آپریٹر سافٹ ویئر اور کسی بھی گیٹ وے کے ساتھ پیمنٹ گیٹ وے انٹیگریشن کے لیے کام کرتی ہے؛ صرف فیلڈ کے نام بدلتے ہیں۔
انٹیگریشن کے انداز
REST، XML، SOAP، ویب ہکس اور GraphQL
سپلائرز اپنے انٹرفیس مختلف انداز میں شائع کرتے ہیں۔ انداز سپلائر کی دستاویزات طے کرتی ہیں، پسند نہیں، اس لیے ٹریول پلیٹ فارم کو یہ سب بولنے آنے چاہئیں۔
REST اور JSON
JSON- ڈیٹا فارمیٹ
- JSON دستاویزات
- ٹرانسپورٹ
- HTTP میتھڈز: GET، POST، PUT، DELETE
- ٹریول میں عام
- نئے فلائٹ، ہوٹل، ایکٹیویٹی اور پیمنٹ APIs
- خوبی
- مختصر پے لوڈز اور وسیع ڈیولپر ٹولنگ
- خیال رکھیں
- ڈھیلی تعریف؛ ہر سپلائر REST کو الگ سمجھتا ہے
XML اور SOAP
XML- ڈیٹا فارمیٹ
- XML دستاویزات، اکثر سخت اسکیما کے ساتھ
- ٹرانسپورٹ
- SOAP لفافے یا سادہ XML کے ساتھ HTTP POST
- ٹریول میں عام
- GDS، بیڈ بینکس اور قائم شدہ ہوٹل اور ٹور سسٹمز
- خوبی
- رسمی معاہدے، دستخط اور سروس تعریفیں
- خیال رکھیں
- طویل پیغامات اور بھاری پارسنگ
ویب ہکس
EVENT- ڈیٹا فارمیٹ
- JSON یا XML، دوسری طرف سے بھیجا گیا
- ٹرانسپورٹ
- آپ کے رجسٹرڈ URL پر HTTP POST
- ٹریول میں عام
- ادائیگی کے نتائج، بکنگ اسٹیٹس کی تبدیلیاں، ٹکٹنگ اپڈیٹس
- خوبی
- پولنگ نہیں؛ کچھ ہونے پر آپ کے پلیٹ فارم کو بتایا جاتا ہے
- خیال رکھیں
- دستخط کی تصدیق اور دہرائی کی ہینڈلنگ ضروری
GraphQL
QUERY- ڈیٹا فارمیٹ
- JSON، آپ کی بھیجی گئی کوئری کی شکل میں
- ٹرانسپورٹ
- ایک ہی HTTP اینڈ پوائنٹ
- ٹریول میں عام
- کچھ نئے ڈسٹری بیوشن پلیٹ فارمز اور اندرونی APIs
- خوبی
- بالکل وہی فیلڈز مانگیں جو آپ کو چاہئیں
- خیال رکھیں
- ٹریول میں سپلائر سپورٹ ابھی کم ہے
API انٹیگریشن بمقابلہ API ڈیولپمنٹ
آپ کی پروڈکٹ کو پہلے سے موجود انٹرفیس سے جوڑتا ہے۔ API سپلائر کی ہے؛ آپ کلائنٹ، میپنگ اور اس کے گرد قواعد بناتے ہیں۔
ایسا انٹرفیس بناتا ہے جسے دوسرے سسٹم آپ کی پروڈکٹ سے جڑنے کے لیے استعمال کرتے ہیں، جیسے B2B API جسے آپ کے ایجنٹس کے ٹولز کال کر سکیں۔ معاہدہ اور اس کے ورژن آپ کے ہیں۔
بہت سے ٹریول پراجیکٹس کو دونوں چاہئیں: پلیٹ فارم ایک طرف سپلائرز کو انٹیگریٹ کرتا ہے اور دوسری طرف ایجنٹس اور پارٹنرز کے لیے اپنا API شائع کرتا ہے۔
پہلے اور بعد
سسٹم انٹیگریٹ ہونے پر کیا بدلتا ہے
بکنگ کے وہی پانچ مراحل، سپلائر پورٹلز پر ہاتھ سے کیے گئے اور API انٹیگریشن کے ذریعے کیے گئے۔
سرچ
ایجنٹ ہر سپلائر پورٹل کھول کر قیمتیں کوٹیشن میں نقل کرتا ہے۔
ایک سرچ ہر جڑے سپلائر تک جاتی ہے اور ایک ہی فہرست واپس لاتی ہے۔
قیمت
مارک اپ اسپریڈ شیٹ میں شامل ہوتا ہے؛ کوٹیشن بھیجنے تک ریٹ بدل چکا ہو سکتا ہے۔
مارک اپ، ٹیکس اور کرنسی کے قواعد رسپانس کے وقت لاگو ہوتے ہیں؛ ادائیگی سے پہلے ریٹ دوبارہ جانچا جاتا ہے۔
بکنگ
مہمان کی تفصیلات سپلائر پورٹل میں دوبارہ ٹائپ ہوتی ہیں؛ ٹائپو بکنگ کی غلطیاں بن جاتے ہیں۔
تفصیلات ایک بار بھیجی جاتی ہیں، تصدیق ہوتی ہے اور سپلائر کی کنفرمیشن کے ساتھ محفوظ ہوتی ہیں۔
ادائیگی
ادائیگی الگ وصول کی جاتی ہے اور بعد میں بکنگ سے ملائی جاتی ہے۔
اتھارائزیشن، کیپچر اور ریفنڈ بکنگ ریفرنس سے بندھے رہتے ہیں۔
سروس
منسوخی اور تبدیلی کا مطلب ایک اور لاگ ان اور ایک اور ای میل۔
تبدیلیاں اور منسوخیاں اسی کنکشن سے ہوتی ہیں اور ریکارڈ اپڈیٹ کرتی ہیں۔
ٹریول پلیٹ فارم میں API انٹیگریشن کہاں نظر آتا ہے
- فلائٹ بکنگ سافٹ ویئرفلائٹس بیچنے والی ایجنسیوں اور OTA کے لیے چیک لسٹ
- ہوٹل بکنگ انجناپنی ہوٹل ویب سائٹ پر براہ راست بکنگ
- ٹور آپریٹر سافٹ ویئربکنگ، سفری پروگرام، B2B ری سیلرز اور آپریشنز
- کار رینٹل سسٹماپنا فلیٹ، برانچز اور ڈپازٹ آن لائن چلائیں
- پیمنٹ گیٹ وے انٹیگریشنچیک آؤٹ، 3D Secure، ریفنڈز اور ویب ہکس
- ٹریول ایجنسی CRMلیڈز، کوٹیشن، بکنگ اور انوائس ایک CRM میں
اصطلاحات
API دستاویزات میں ملنے والی اصطلاحات
بارہ الفاظ جو تقریباً ہر سپلائر کے ڈیولپر پورٹل میں آتے ہیں، ٹریول میں جس طرح استعمال ہوتے ہیں اسی طرح بیان کیے گئے۔
API
ایپلیکیشن پروگرامنگ انٹرفیس: کسی سسٹم سے بات کرنے کے شائع شدہ قواعد۔
تصدیق
یہ ثابت کرنا کہ کون کال کر رہا ہے، API کلید، بیئرر ٹوکن، دستخط یا منظور شدہ IP ایڈریس سے۔
سرٹیفکیشن
پروڈکشن کریڈینشلز جاری کرنے سے پہلے سپلائر کی طرف سے آپ کے انٹیگریشن کا جائزہ۔
اینڈ پوائنٹ
ایک آپریشن کے لیے ایک پتہ، جیسے سرچ، بکنگ یا منسوخی۔
آئیڈیمپوٹینسی
ایک ہی ریکوئسٹ دو بار بھیجنے پر ایک ہی نتیجہ آتا ہے، جس سے دوہری بکنگ اور دوہرے چارج رکتے ہیں۔
میپنگ
سپلائر کے فیلڈز، کوڈز اور ناموں کو آپ کے پلیٹ فارم کے اپنے ڈیٹا ماڈل میں ترجمہ کرنا۔
پے لوڈ
ریکوئسٹ یا رسپانس کے اندر لے جایا گیا ڈیٹا، عموماً JSON یا XML۔
ریٹ لمٹ
کالز کی وہ تعداد جو سپلائر فی سیکنڈ یا فی دن انکار شروع کرنے سے پہلے اجازت دیتا ہے۔
ریکوئسٹ اور رسپانس
ایک کال: آپ کا پلیٹ فارم پوچھتا ہے، سپلائر جواب دیتا ہے، اور دونوں فریق اسے لاگ کرتے ہیں۔
سینڈ باکس
نقلی انوینٹری اور ٹیسٹ کارڈز والا ٹیسٹ ماحول جہاں حقیقت میں کچھ بک یا چارج نہیں ہوتا۔
اسٹیٹس کوڈ
نتیجے کا خلاصہ بتانے والا HTTP نمبر: 200 کامیابی، 401 غیر مجاز، 429 ریٹ لمٹ، 500 سپلائر کی خرابی۔
ویب ہک
الٹی سمت کی کال: کوئی واقعہ ہونے پر سپلائر یا گیٹ وے آپ کے پلیٹ فارم کو مطلع کرتا ہے۔
ٹیسٹنگ اور اسکوپنگ
لائیو ہونے سے پہلے ٹریول API انٹیگریشن کی ٹیسٹنگ کیسے ہوتی ہے
انٹیگریشن تبھی مکمل ہوتا ہے جب ناکامی کے راستے بھی درست رویہ دکھائیں۔ سپلائر سینڈ باکس پر ایک ٹیسٹ رن سرٹیفکیشن اور پروڈکشن کریڈینشلز پر منتقلی سے پہلے نیچے دیے گئے کیسز کا احاطہ کرتا ہے۔
run integration tests
سپلائر سینڈ باکس، نو کیسز
- OK: درست اور زائد المیعاد کریڈینشلز کے ساتھ تصدیق
- OK: غلط ریکوئسٹ پڑھنے کے قابل ایرر کے ساتھ مسترد
- OK: سپلائر ٹائم آؤٹ بغیر لٹکی بکنگ کے ہینڈل کیا گیا
- OK: ریٹ لمٹ کا احترام اور انتظار کے بعد دوبارہ کوشش
- OK: دوبارہ جانچ میں قیمت کی تبدیلی پکڑی گئی اور ادائیگی سے پہلے دکھائی گئی
- OK: دوہری سبمیشن پہلی بکنگ واپس کرتی ہے، دوسری نہیں
- OK: منسوخی لاگو اور فیس کا حساب
- OK: اصل ادائیگی کے مقابل ریفنڈ جاری
- OK: بکنگ، ادائیگی اور سپلائر ریفرنسز کا ملاپ
تمام کیسز پاس، سرٹیفکیشن کے لیے تیار
اسکوپنگ کے لیے آپ سے کیا درکار ہے
- 1سپلائر معاہدہ، دستاویزات اور سینڈ باکس کریڈینشلز
- 2مارکیٹس، کرنسیاں، پروڈکٹس اور یوزر رولز
- 3سرچ، بکنگ، تبدیلی، منسوخی اور ریفنڈ کا دائرہ
- 4سرٹیفکیشن کی ضروریات اور پروڈکشن رسائی کا عمل
سپلائر جوڑنے کے لیے تیار
PHPTRAVELS سپلائرز، گیٹ ویز اور کاروباری ٹولز کو سورس کوڈ کے ساتھ فراہم کیے گئے سیلف ہوسٹڈ پلیٹ فارم میں انٹیگریٹ کرتا ہے۔ تین یکمشت پلانز کے لیے قیمتیں دیکھیں، یا کسی مخصوص API کے بارے میں ہم سے پوچھیں۔
سوالات
API انٹیگریشن کے سوالات، جوابات کے ساتھ
پہلے انٹیگریشن پراجیکٹ سے پہلے لوگ جو سوال پوچھتے ہیں، ان کے مختصر جواب۔
سیلز سے بات کریںAPI انٹیگریشن ایک کنکشن ہے جس کے ذریعے دو سافٹ ویئر سسٹم خود بخود ڈیٹا کا تبادلہ کرتے اور عمل شروع کرتے ہیں۔ ایک سسٹم منظم ریکوئسٹ بھیجتا ہے، دوسرا منظم رسپانس واپس کرتا ہے، اور دونوں سیکیورٹی اور ڈیٹا کے طے شدہ قواعد پر عمل کرتے ہیں۔
ٹریول میں یہ بکنگ پلیٹ فارم کو فلائٹ، ہوٹل، ٹور یا کار سپلائرز، پیمنٹ گیٹ ویز اور کاروباری ٹولز سے جوڑتا ہے۔ یہ دوبارہ ٹائپ کیے بغیر سرچ، قیمت کی تصدیق، بکنگ، منسوخی، ریفنڈ اور ملاپ کو سپورٹ کرتا ہے۔
REST ایک آرکیٹیکچرل انداز ہے جو عموماً HTTP پر JSON کا تبادلہ کرتا ہے۔ XML ایک ڈیٹا فارمیٹ ہے جو GDS اور بیڈ بینک سپلائرز میں اب بھی عام ہے، اکثر SOAP میں لپٹا ہوا۔ سپلائر کا معاہدہ اور دستاویزات طے کرتی ہیں کہ آپ کون سا استعمال کریں گے۔
یہ سپلائر رسائی، دائرے میں شامل اینڈ پوائنٹس، سرٹیفکیشن، میپنگ قواعد اور بکنگ کے خاص کیسز پر منحصر ہے۔ قابل اعتماد تخمینہ دستاویزات، کریڈینشلز اور آپ کے مطلوبہ ورک فلوز کے جائزے کے بعد ہی ملتا ہے۔
تصدیق، درست اور غلط ریکوئسٹس، ٹائم آؤٹس، ریٹ لمٹس، قیمت کی تبدیلیاں، دوہری سبمیشنز، منسوخیاں، ریفنڈز اور ملاپ کو ٹیسٹ کریں۔ پروڈکشن میں ہر ریکوئسٹ کسی بکنگ ریفرنس تک ٹریس ہونی چاہیے۔
نہیں۔ انٹیگریشن آپ کی پروڈکٹ کو موجودہ API سے جوڑتا ہے؛ ڈیولپمنٹ ایسا انٹرفیس بناتا ہے جس سے دوسرے جڑتے ہیں۔ ٹریول پلیٹ فارمز کو اکثر دونوں چاہئیں: ایک طرف انٹیگریٹ شدہ سپلائرز اور دوسری طرف پارٹنرز کے لیے شائع شدہ B2B API۔
مزید دیکھیں
