Demo ya moja kwa moja

Mwongozo

Muunganisho wa API ni nini, ikielezwa kwa biashara za usafiri

Muunganisho wa API ni kiunganishi kinachoruhusu mifumo miwili ya programu kubadilishana data na kuanzisha vitendo bila mtu kuandika upya chochote. Mwongozo huu unaeleza jinsi unavyofanya kazi, ukitumia uhifadhi mmoja wa hoteli unaosafiri kati ya msafiri, jukwaa la uhifadhi, API ya msambazaji na lango la malipo.

  • Ombi moja, jibu moja
  • REST, XML, SOAP na webhook
  • Uhifadhi mmoja ukifuatiliwa katika mifumo minne
  • Jinsi miunganisho inavyojaribiwa

Ufafanuzi

Muunganisho wa API ni nini, kwa lugha rahisi

API inamaanisha application programming interface: seti ya sheria ambazo mfumo huchapisha ili programu nyingine ziweze kuwasiliana nao. Muunganisho wa API ni kazi ya kuunganisha jukwaa lako na mojawapo ya violesura hivyo ili data isafiri na vitendo vifanyike kiotomatiki.

Katika usafiri, jukwaa hilo kwa kawaida ni mfumo wa uhifadhi kama Programu ya kuhifadhi safari, na kiolesura ni cha msambazaji, lango la malipo au zana ya biashara. Ukurasa wetu wa Muunganisho wa API za usafiri unaeleza jinsi PHPTRAVELS inavyotoa miunganisho hii, na Miunganisho yote inaorodhesha wasambazaji ambao tayari wameunganishwa.

  • Kubadilishana data

    Viwango, upatikanaji, maelezo ya wateja na masasisho ya hali husafiri kati ya mifumo katika muundo uliopangwa.

  • Kufanya vitendo kiotomatiki

    Kutafuta, kuhifadhi, kulipa, kughairi na kulinganisha hufanyika kama maombi, si kama hatua ambazo mtu hurudia kwa mkono.

  • Kufuatilia matokeo

    Kila wito hubeba rejeleo, hivyo uhifadhi ulioshindwa unaweza kufuatiliwa hadi ombi lililousababisha.

Ombi

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"}

Jibu

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"}
Wito wa mfano kwa msambazaji wa hoteli wa kubuni. Majina ya sehemu, endpoint na kiasi hutofautiana kati ya msambazaji mmoja na mwingine.

Muundo wa wito mmoja wa API

  1. 1

    Endpoint na mbinu

    Anwani ya operesheni na kitenzi kinachotumika juu yake: POST kwa availability inamaanisha kutafuta vyumba.

  2. 2

    Uthibitishaji

    Ufunguo, tokeni au sahihi huthibitisha ni nani anayeita. Wasambazaji hutoa vitambulisho tofauti kwa sandbox na uzalishaji.

  3. 3

    Payload

    Ingizo lililopangwa: jiji, tarehe, wageni na sarafu. Nyaraka za msambazaji hufafanua kila sehemu.

  4. 4

    Msimbo wa hali

    Nambari inayosema jinsi wito ulivyoenda: 200 ni mafanikio, 4xx ni tatizo la ombi, 5xx ni tatizo upande wa msambazaji.

  5. 5

    Kitambulisho cha ombi

    Kitambulisho ambacho pande zote mbili huhifadhi. Wakati usaidizi unapouliza nini kilitokea kwa uhifadhi, hiki ndicho wanachotafuta.

  6. 6

    Mwili wa jibu

    Jibu katika muundo wa msambazaji, ambalo jukwaa lako hulinganisha na vyumba, viwango na sera zake.

Uhifadhi mmoja, mifumo minne

Muunganisho wa API hufanya nini wakati wa uhifadhi wa hoteli

Fuata ukaaji mmoja wa usiku mbili kuanzia utafutaji hadi vocha. Kila mshale ni wito wa API; msafiri huona wa kwanza na wa mwisho tu.

  1. 01MsafiriJukwaa la uhifadhiAnatafuta hoteli Dubai, usiku mbili, wageni wawili
  2. 02Jukwaa la uhifadhiAPI ya msambazajiOmbi la upatikanaji lenye tarehe, wageni na sarafu
  3. 03API ya msambazajiJukwaa la uhifadhiVyumba, viwango, sera na ufunguo wa kiwango
  4. 04Jukwaa la uhifadhiMsafiriMatokeo yanaonyeshwa na markup yako na sarafu yako ikitumika
  5. 05Jukwaa la uhifadhiAPI ya msambazajiUkaguzi upya wa bei kwenye ufunguo wa kiwango uliochaguliwa kabla ya malipo
  6. 06Jukwaa la uhifadhiLango la malipoIdhini ya malipo kwa jumla
  7. 07Lango la malipoJukwaa la uhifadhiImeidhinishwa, webhook iliyosainiwa imepokelewa
  8. 08Jukwaa la uhifadhiAPI ya msambazajiOmbi la uhifadhi lenye maelezo ya mgeni
  9. 09API ya msambazajiJukwaa la uhifadhiNambari ya uthibitisho na masharti ya kughairi
  10. 10Jukwaa la uhifadhiMsafiriVocha, ankara na rejeleo la uhifadhi

Jukwaa lililo katikati ndipo muunganisho wa API unapoishi: hutafsiri kati ya skrini ya msafiri na muundo wa kila msambazaji, na huhifadhi kila rejeleo.

Mfuatano huo huo hutumikia Programu ya kuhifadhi ndege na GDS, Programu ya waendeshaji watalii na msambazaji wa shughuli na Uunganishaji wa lango za malipo na lango lolote; majina ya sehemu pekee ndiyo hubadilika.

Mitindo ya muunganisho

REST, XML, SOAP, webhook na GraphQL

Wasambazaji huchapisha violesura vyao kwa mitindo tofauti. Mtindo huamuliwa na nyaraka za msambazaji, si na upendeleo, hivyo jukwaa la usafiri linahitaji kuvielewa vyote.

  • REST na JSON

    JSON
    Muundo wa data
    Hati za JSON
    Usafirishaji
    Mbinu za HTTP: GET, POST, PUT, DELETE
    Kawaida katika usafiri
    API mpya za ndege, hoteli, shughuli na malipo
    Nguvu
    Payload fupi na zana nyingi za wasanidi programu
    Tahadhari
    Haijabainishwa kwa ukali; kila msambazaji hutafsiri REST kwa njia tofauti

  • XML na SOAP

    XML
    Muundo wa data
    Hati za XML, mara nyingi zenye schema kali
    Usafirishaji
    HTTP POST yenye bahasha ya SOAP au XML tupu
    Kawaida katika usafiri
    GDS, bedbank na mifumo iliyoimarika ya hoteli na ziara
    Nguvu
    Mikataba rasmi, sahihi na ufafanuzi wa huduma
    Tahadhari
    Ujumbe mrefu na uchakataji mzito zaidi

  • Webhook

    EVENT
    Muundo wa data
    JSON au XML, ikisukumwa na upande mwingine
    Usafirishaji
    HTTP POST kwa URL unayosajili
    Kawaida katika usafiri
    Matokeo ya malipo, mabadiliko ya hali ya uhifadhi, masasisho ya utoaji tiketi
    Nguvu
    Hakuna polling; jukwaa lako huambiwa jambo linapotokea
    Tahadhari
    Sahihi lazima zithibitishwe na marudio yashughulikiwe

  • GraphQL

    QUERY
    Muundo wa data
    JSON, ikiumbwa na hoja unayotuma
    Usafirishaji
    Endpoint moja ya HTTP
    Kawaida katika usafiri
    Baadhi ya majukwaa mapya ya usambazaji na API za ndani
    Nguvu
    Omba sehemu unazohitaji hasa
    Tahadhari
    Usaidizi wa wasambazaji katika usafiri bado si wa kawaida

Muunganisho wa API dhidi ya uundaji wa API

Muunganisho wa API

Huunganisha bidhaa yako na kiolesura ambacho tayari kipo. Msambazaji anamiliki API; wewe unajenga mteja, ulinganishaji na sheria zinazoizunguka.

Uundaji wa API

Huunda kiolesura ambacho mifumo mingine hutumia kuunganishwa na bidhaa yako, kama API ya B2B ambayo zana za mawakala wako zinaweza kuita. Wewe unamiliki mkataba na matoleo yake.

Miradi mingi ya usafiri inahitaji yote mawili: jukwaa huunganisha wasambazaji upande mmoja na huchapisha API yake kwa mawakala na washirika upande mwingine.

Kabla na baada

Nini hubadilika mifumo inapounganishwa

Hatua zile zile tano za uhifadhi, zikifanywa kwa mkono kwenye tovuti za wasambazaji na zikifanywa kupitia muunganisho wa API.

Kutafuta

Bila muunganishoKwa mkono

Wakala hufungua kila tovuti ya msambazaji na kunakili bei kwenye nukuu.

Na muunganisho wa APIKiotomatiki

Utafutaji mmoja husambaa kwa kila msambazaji aliyeunganishwa na kurudisha orodha moja.

Bei

Bila muunganishoKwa mkono

Markup huongezwa kwenye lahajedwali; kiwango kinaweza kuwa kimebadilika wakati nukuu inatumwa.

Na muunganisho wa APIKiotomatiki

Markup, kodi na sheria za sarafu hutumika wakati wa jibu; kiwango hukaguliwa upya kabla ya malipo.

Kuhifadhi

Bila muunganishoKwa mkono

Maelezo ya mgeni huandikwa upya kwenye tovuti ya msambazaji; makosa ya kuandika huwa makosa ya uhifadhi.

Na muunganisho wa APIKiotomatiki

Maelezo hutumwa mara moja, huthibitishwa na kuhifadhiwa pamoja na uthibitisho wa msambazaji.

Kulipa

Bila muunganishoKwa mkono

Malipo hukusanywa tofauti na kulinganishwa na uhifadhi baadaye.

Na muunganisho wa APIKiotomatiki

Idhini, ukusanyaji na urejeshaji wa fedha huunganishwa na rejeleo la uhifadhi.

Huduma

Bila muunganishoKwa mkono

Kughairi na mabadiliko humaanisha kuingia tena na barua pepe nyingine.

Na muunganisho wa APIKiotomatiki

Mabadiliko na kughairi hupitia muunganisho ule ule na kusasisha rekodi.

Mahali muunganisho wa API unapoonekana katika jukwaa la usafiri

Msamiati

Maneno utakayokutana nayo katika nyaraka za API

Maneno kumi na mawili yanayoonekana katika tovuti ya wasanidi ya karibu kila msambazaji, yakifafanuliwa jinsi yanavyotumika katika usafiri.

  • API

    Application programming interface: sheria zilizochapishwa za kuwasiliana na mfumo.

  • Uthibitishaji

    Kuthibitisha ni nani anayeita, kwa ufunguo wa API, tokeni ya bearer, sahihi au anwani ya IP iliyoidhinishwa.

  • Uidhinishaji

    Ukaguzi wa msambazaji wa muunganisho wako kabla ya vitambulisho vya uzalishaji kutolewa.

  • Endpoint

    Anwani moja kwa operesheni moja, kama kutafuta, kuhifadhi au kughairi.

  • Idempotency

    Kutuma ombi lile lile mara mbili hutoa matokeo moja, jambo linalozuia uhifadhi na malipo marudio.

  • Ulinganishaji

    Kutafsiri sehemu, misimbo na majina ya msambazaji kuwa muundo wa data wa jukwaa lako.

  • Payload

    Data inayobebwa ndani ya ombi au jibu, kwa kawaida JSON au XML.

  • Kikomo cha wito

    Idadi ya wito ambayo msambazaji huruhusu kwa sekunde au kwa siku kabla ya kuanza kuikataa.

  • Ombi na jibu

    Wito mmoja: jukwaa lako huuliza, msambazaji hujibu, na pande zote mbili huirekodi.

  • Sandbox

    Mazingira ya majaribio yenye hesabu ya kubuni na kadi za majaribio ambapo hakuna kinachohifadhiwa au kulipwa kweli.

  • Msimbo wa hali

    Nambari ya HTTP inayofupisha matokeo: 200 mafanikio, 401 haijaidhinishwa, 429 kikomo cha wito, 500 hitilafu ya msambazaji.

  • Webhook

    Wito katika mwelekeo mwingine: msambazaji au lango huarifu jukwaa lako tukio linapotokea.

Majaribio na upeo

Jinsi muunganisho wa API wa usafiri unavyojaribiwa kabla ya kuanza kutumika

Muunganisho humalizika tu wakati njia za hitilafu zinapofanya kazi ipasavyo. Jaribio dhidi ya sandbox ya msambazaji hushughulikia kesi zilizo hapa chini kabla ya uidhinishaji na kubadili kwenda vitambulisho vya uzalishaji.

endesha majaribio ya muunganisho

sandbox ya msambazaji, kesi tisa

  • OK: Uthibitishaji kwa vitambulisho halali na vilivyoisha muda
  • OK: Ombi batili limekataliwa na hitilafu inayosomeka
  • OK: Muda wa msambazaji kuisha umeshughulikiwa bila uhifadhi kuning'inia
  • OK: Kikomo cha wito kimeheshimiwa na kujaribiwa tena baada ya kusubiri
  • OK: Mabadiliko ya bei yamegunduliwa wakati wa ukaguzi upya na kuonyeshwa kabla ya malipo
  • OK: Uwasilishaji marudio hurudisha uhifadhi wa kwanza, si wa pili
  • OK: Kughairi kumetekelezwa na ada zimekokotolewa
  • OK: Urejeshaji wa fedha umetolewa dhidi ya malipo ya awali
  • OK: Marejeleo ya uhifadhi, malipo na msambazaji yanalingana

Kesi zote zimefaulu, tayari kwa uidhinishaji

Upeo unahitaji nini kutoka kwako

  1. 1Makubaliano ya msambazaji, nyaraka na vitambulisho vya sandbox
  2. 2Masoko, sarafu, bidhaa na majukumu ya watumiaji
  3. 3Upeo wa utafutaji, uhifadhi, mabadiliko, kughairi na urejeshaji wa fedha
  4. 4Mahitaji ya uidhinishaji na mchakato wa kupata ufikiaji wa uzalishaji

Tayari kuunganisha msambazaji

PHPTRAVELS huunganisha wasambazaji, malango na zana za biashara katika jukwaa linalojihifadhi lenyewe linalotolewa pamoja na msimbo wake wa chanzo. Tazama Bei kwa mipango mitatu ya malipo ya mara moja, au tuulize kuhusu API mahususi.

Omba onyeshoZungumza nasi

Endelea kusoma

Maswali

Maswali ya muunganisho wa API, yakijibiwa

Majibu mafupi kwa maswali ambayo watu huuliza kabla ya mradi wao wa kwanza wa muunganisho.

Zungumza na mauzo

Muunganisho wa API ni kiunganishi kinachoruhusu mifumo miwili ya programu kubadilishana data na kuanzisha vitendo kiotomatiki. Mfumo mmoja hutuma ombi lililopangwa, mwingine hurudisha jibu lililopangwa, na yote miwili hufuata sheria zilizokubaliwa za usalama na data.

Katika usafiri huunganisha jukwaa la uhifadhi na wasambazaji wa ndege, hoteli, ziara au magari, malango ya malipo na zana za biashara. Unasaidia utafutaji, uthibitishaji wa bei, uhifadhi, kughairi, urejeshaji wa fedha na ulinganishaji bila kuandika upya.

REST ni mtindo wa usanifu ambao kwa kawaida hubadilishana JSON kupitia HTTP. XML ni muundo wa data ambao bado ni wa kawaida kati ya wasambazaji wa GDS na bedbank, mara nyingi ukifungwa katika SOAP. Mkataba na nyaraka za msambazaji huamua utakayotumia.

Inategemea ufikiaji wa msambazaji, endpoint zilizo katika upeo, uidhinishaji, sheria za ulinganishaji na kesi za pembeni za uhifadhi. Makadirio ya kuaminika hufuata ukaguzi wa nyaraka, vitambulisho na mtiririko wa kazi unaohitaji.

Jaribu uthibitishaji, maombi halali na batili, muda kuisha, vikomo vya wito, mabadiliko ya bei, uwasilishaji marudio, kughairi, urejeshaji wa fedha na ulinganishaji. Katika uzalishaji, kila ombi linapaswa kufuatiliwa hadi rejeleo la uhifadhi.

Hapana. Muunganisho huunganisha bidhaa yako na API iliyopo; uundaji huunda kiolesura ambacho wengine huunganishwa nacho. Majukwaa ya usafiri mara nyingi huhitaji yote mawili: wasambazaji waliounganishwa upande mmoja na API ya B2B iliyochapishwa kwa washirika upande mwingine.

Endelea kuchunguza

Zaidi kuhusu jukwaa