התחלה מהירה

1. קבלו פרטי גישה ל-Sandbox

הירשמו בעמוד ממשקי התיירות. ברגע שכתובת הדוא״ל שלכם מאומתת, חשבון השותף שלכם קיים ומזהה מפתח Sandbox מוצג על המסך; הסוד נמסר בקישור חשיפה חד-פעמי שנשלח לאותה כתובת. שמרו אותו במנהל הסודות שלכם — הוא מוצג פעם אחת בלבד.

תקבלו גם סיסמה זמנית לפורטל המפתחים, שבו אפשר ליצור ולהחליף מפתחות, להגדיר רשימת היתרי IP, לעקוב אחר השימוש ולבקש ייצור.

2. חתמו על כל בקשה

כל קריאה כוללת ארבע כותרות: X-API-Key (מזהה המפתח שלכם), X-Timestamp (שניות unix), X-Nonce (16–128 תווים אקראיים) וכן X-Signature — חתימת HMAC-SHA256 בהקסדצימלי באותיות קטנות של מחרוזת קנונית, עם הסוד שלכם כמפתח.

המחרוזת הקנונית היא חמש שורות המחוברות בתו שורה חדשה: שיטת ה-HTTP באותיות גדולות, הנתיב יחד עם מחרוזת השאילתה בדיוק כפי שנשלחו, חותמת הזמן, ה-nonce, וה-SHA-256 בהקסדצימלי באותיות קטנות של הגוף הגולמי (לגוף ריק מחושב ה-SHA-256 של אפס בתים). חותמת הזמן חייבת להיות בטווח של 300 שניות מהשעון שלנו; בכל nonce אפשר להשתמש פעם אחת בתוך 10 דקות.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. בצעו את הקריאה הראשונה

חפשו טיסה בסביבת Sandbox. סביבת Sandbox מחוברת לסביבות הבדיקה של הספקים שלנו, כך שהחיפושים מחזירים מלאי ומחירי בדיקה, והזמנה שמתבצעת בה היא הזמנת בדיקה — בלי כרטיס אמיתי ובלי חיוב. בכל עמוד עיון יש דוגמה מלאה עבור cURL, Node.js, Python וגם PHP — העתיקו אותה, מלאו את מזהה המפתח והסוד שלכם, והריצו.

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. השלימו תהליך הזמנה

טיסות: חיפוש ← תמחור ההצעה שנבחרה ← יצירת הזמנה עם נוסעים ואיש קשר ← הנפקת כרטיס ← (אופציונלי) הצעת מחיר להחזר ובקשת החזר. מלונות: חיפוש ← קריאת החדרים של נכס ← בדיקת התעריף ← יצירת ההזמנה ← (אופציונלי) הצעת מחיר לביטול וביטול.

מזהי הצעות ומפתחות תעריף הם אטומים וקצרי חיים. תמיד תמחרו או בדקו ממש לפני ההתחייבות: אם המחיר השתנה תקבלו 409 price_changed עם הסכום החדש, וההחלטה בידיכם.

5. בקשו ייצור

כשהאינטגרציה שלכם משלימה את התהליך מקצה לקצה ב-Sandbox, פתחו את פורטל המפתחים ובקשו ייצור. אנחנו בודקים את הפעילות ב-Sandbox (חיפושים, הזמנת טיסה, הזמנת מלון, ביטול) ואת פרטי האינטגרציה, ואז מעבירים את החשבון שלכם: זוג מפתחות ייצור נשלח בדוא״ל דרך אותו קישור חשיפה חד-פעמי. אותה כתובת בסיס — בקשות שנחתמו במפתח dt_live_ מגיעות לספקים החיים ומתחשבנות מול הפיקדון שלכם; מפתח ה-Sandbox ממשיך לפעול לבדיקות.