Kuanza haraka

1. Pata vitambulisho vya sandbox

Jisajili kwenye ukurasa wa API za usafiri. Barua pepe yako ikishathibitishwa, akaunti yako ya mshirika inakuwepo na kitambulisho cha ufunguo wa sandbox kinaonyeshwa kwenye skrini; siri inawasilishwa kupitia kiungo cha kufichua cha matumizi mara moja kinachotumwa kwa anwani ile ile. Ihifadhi kwenye kidhibiti chako cha siri — inaonyeshwa mara moja tu.

Pia unapokea nenosiri la muda la lango la wasanidi programu, ambapo unaweza kuunda na kubadilisha funguo, kuweka orodha ya IP zinazoruhusiwa, kufuatilia matumizi na kuomba uzalishaji.

2. Tia sahihi kila ombi

Kila mwito hubeba vichwa vinne: X-API-Key (kitambulisho cha ufunguo wako), X-Timestamp (sekunde za unix), X-Nonce (vibambo nasibu 16–128) na X-Signature — HMAC-SHA256 ya hex kwa herufi ndogo ya mfuatano wa kawaida, uliokokotolewa kwa siri yako.

Mfuatano wa kawaida ni mistari mitano iliyounganishwa kwa herufi ya mstari mpya: mbinu ya HTTP kwa herufi kubwa, njia pamoja na mfuatano wa hoja kama ulivyotumwa, muhuri wa muda, nonce, na SHA-256 ya hex kwa herufi ndogo ya mwili ghafi (mwili mtupu hupata hashi ya SHA-256 ya baiti sifuri). Muhuri wa muda lazima uwe ndani ya sekunde 300 za saa yetu; nonce inaweza kutumika mara moja ndani ya dakika 10.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Fanya mwito wako wa kwanza

Tafuta safari ya ndege kwenye sandbox. Sandbox imeunganishwa na mazingira ya majaribio ya wasambazaji wetu, kwa hiyo utafutaji hurudisha hazina na bei za majaribio, na uhifadhi unaofanywa huko ni wa majaribio — hakuna tiketi halisi, hakuna malipo. Kila ukurasa wa marejeleo una mfano kamili katika cURL, Node.js, Python na PHP — unakili, jaza kitambulisho cha ufunguo na siri yako, uuendeshe.

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. Kamilisha mtiririko wa kuweka nafasi

Ndege: utafutaji → pata bei ya ofa uliyochagua → unda oda pamoja na abiria na mawasiliano → toa tiketi → (hiari) pata makadirio na uombe marejesho. Hoteli: utafutaji → soma vyumba vya malazi → kagua bei → unda uhifadhi → (hiari) pata makadirio na ughairi.

Vitambulisho vya ofa na funguo za bei havina maana ya ndani na ni vya muda mfupi. Kila mara pata bei au kagua kabla tu ya kuthibitisha: bei ikibadilika utapokea 409 price_changed pamoja na kiasi kipya, nawe utaamua.

5. Omba uzalishaji

Muunganisho wako ukikamilisha mtiririko mwanzo hadi mwisho kwenye sandbox, fungua lango la wasanidi programu na uombe uzalishaji. Tunakagua shughuli za sandbox (utafutaji, oda, uhifadhi, kughairi) na maelezo ya muunganisho wako, kisha tunahamisha akaunti yako: jozi ya funguo za uzalishaji inatumwa kwa barua pepe kupitia kiungo kile kile cha kufichua cha matumizi mara moja. URL ya msingi ni ile ile — maombi yaliyotiwa sahihi kwa ufunguo wa dt_live_ hufikia wasambazaji halisi na hulipwa kutoka kwenye amana yako; ufunguo wako wa sandbox unaendelea kufanya kazi kwa majaribio.