Skip to content

البداية السريعة

من بيانات الاعتماد إلى حجز مؤكد في خمس طلبات.

توصلك خمس طلبات من بيانات الاعتماد إلى حجز مؤكد. تعمل جميع الأمثلة التالية على البيئة التجريبية، التي تعيد استجابات مكتملة البنية حتى تتمكن من بناء التدفق كاملًا قبل توقيع أي اتفاقية تجارية.

1. الحصول على رمز وصول

curl

curl -X POST https://api.travelcore.tech/v1/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=$TRAVELCORE_CLIENT_ID" \
-d "client_secret=$TRAVELCORE_CLIENT_SECRET" \
-d "scope=hotels.search hotels.book"
ملاحظة:تظل رموز الوصول صالحة لمدة 15 دقيقة. خزّن الرمز وأعد استخدامه؛ فطلب رمز جديد مع كل استدعاء للواجهة هو السبب الأكثر شيوعًا للوصول إلى حد الطلبات.

2. البحث

curl

curl -X POST https://api.travelcore.tech/v1/hotels/search \
-H "Authorization: Bearer $TOKEN" \
-H "X-TravelCore-Tenant: $TENANT_ID" \
-H "Content-Type: application/json" \
-d '{
"destination": { "type": "city", "code": "DXB" },
"checkIn": "2026-11-12",
"checkOut": "2026-11-16",
"occupancies": [{ "adults": 2 }],
"currency": "AED",
"nationality": "EG"
}'

افحص مصفوفة suppliers في الاستجابة قبل عرض النتائج. إذا كانت قيمة partial تساوي true، فهذا يعني أن موردًا واحدًا على الأقل تجاوز ميزانيته الزمنية؛ اعرض النتائج المتاحة بدلًا من تعطيل الصفحة، وقرر بشكل منفصل ما إذا كنت ستعيد الطلب.

3. إعادة التحقق من السعر

curl

curl -X POST https://api.travelcore.tech/v1/hotels/rates/rt_01JQ8Y3M9F/check \
-H "Authorization: Bearer $TOKEN" \
-H "X-TravelCore-Tenant: $TENANT_ID"
ملاحظة:لا تتجاوز هذا الطلب أبدًا. قد يعيد المورد تسعير العرض بين البحث والحجز؛ وهنا تكتشف التغيير قبل تحصيل المبلغ من العميل، وليس بعده.

4. إنشاء الحجز

curl

curl -X POST https://api.travelcore.tech/v1/hotels/bookings \
-H "Authorization: Bearer $TOKEN" \
-H "X-TravelCore-Tenant: $TENANT_ID" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"rateId": "rt_01JQ8Y3M9F",
"searchId": "srch_01JQ8Y3M4K7B2R",
"holder": { "firstName": "Sara", "lastName": "Hassan", "email": "sara@example.com" },
"rooms": [{ "guests": [{ "type": "adult", "firstName": "Sara", "lastName": "Hassan" }] }],
"clientReference": "OTA-2026-000148"
}'

5. استرجاع الحجز وإصدار القسيمة

curl

curl https://api.travelcore.tech/v1/hotels/bookings/bkg_01JQ8YB4T2N6 \
-H "Authorization: Bearer $TOKEN" \
-H "X-TravelCore-Tenant: $TENANT_ID"
ملاحظة:عنوان الخادم وبيانات الاعتماد ومعرّف المستأجر أعلاه أمثلة توضيحية. تُصدر بيانات البيئة التجريبية لكل حساب، والواجهة حاليًا في معاينة الشركاء وليست متاحة للتسجيل الذاتي بعد.