Жылдам бастау

1. Sandbox кіру деректерін алыңыз

Саяхат API бетінде тіркеліңіз. Поштаңыз расталғаннан кейін серіктес тіркелгіңіз жасалады және экранда sandbox кілт ID көрсетіледі; құпия кілт сол мекенжайға жіберілетін бір реттік ашу сілтемесі арқылы беріледі. Оны құпиялар менеджерінде сақтаңыз — ол тек бір рет көрсетіледі.

Сондай-ақ әзірлеуші порталына арналған уақытша құпиясөз аласыз; онда кілттер жасап, ауыстыра, IP рұқсат тізімін орната, пайдалануды бақылай және production сұрай аласыз.

2. Әр сұрауға қол қойыңыз

Әр шақыру төрт тақырыпты қамтиды: X-API-Key (кілт ID-іңіз), X-Timestamp (unix секундтары), X-Nonce (16–128 кездейсоқ таңба) және X-Signature — құпия кілтіңізбен есептелген канондық жолдың кіші әріптегі hex HMAC-SHA256 мәні.

Канондық жол жаңа жол таңбасымен біріктірілген бес жолдан тұрады: бас әріптегі HTTP әдісі, жіберілгендей дәл жол мен сұрау жолы, timestamp, nonce және өңделмеген дененің кіші әріптегі hex SHA-256 мәні (бос дене нөл байттың SHA-256 мәні ретінде хэштеледі). Timestamp біздің сағаттан 300 секундтан артық ауытқымауы керек; nonce 10 минут ішінде тек бір рет пайдаланылады.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Алғашқы шақыруды жасаңыз

Sandbox ортасында рейс іздеп көріңіз. Sandbox жеткізушілеріміздің сынақ орталарына қосылған, сондықтан іздеу сынақ қоры мен бағаларын қайтарады, ал онда жасалған брондау — сынақ брондауы: нақты билет те, төлем де жоқ. Әр анықтамалық бетте cURL, Node.js, Python және PHP тілдеріндегі толық үлгі бар — оны көшіріп, кілт ID мен құпия кілтіңізді енгізіп, іске қосыңыз.

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. Брондау процесін аяқтаңыз

Рейстер: іздеу → таңдалған ұсынысты бағалау → жолаушылар мен байланыс деректерімен тапсырыс жасау → билетті рәсімдеу → (қажет болса) қайтару сомасын алу және қайтаруды сұрау. Қонақүйлер: іздеу → нысанның бөлмелерін оқу → тарифті тексеру → брондау жасау → (қажет болса) күшін жою сомасын алу және күшін жою.

Ұсыныс ID-лері мен тариф кілттері мөлдір емес және қысқа мерзімді. Растамас бұрын әрқашан бағаны немесе тарифті тексеріңіз: баға өзгерсе, жаңа сомамен 409 price_changed аласыз, ал шешімді өзіңіз қабылдайсыз.

5. Production сұраңыз

Интеграцияңыз sandbox-та процесті басынан аяғына дейін орындаған кезде әзірлеуші порталын ашып, production сұраңыз. Біз sandbox белсенділігін (іздеулер, тапсырыс, брондау, күшін жою) және интеграция мәліметтеріңізді тексеріп, тіркелгіңізді ауыстырамыз: production кілттер жұбы сол бір реттік ашу сілтемесі арқылы поштаға жіберіледі. Негізгі URL өзгермейді — dt_live_ кілтімен қол қойылған сұраулар нақты жеткізушілерге жетеді және депозитіңізден есептеледі; sandbox кілтіңіз тестілеу үшін жұмысын жалғастырады.