Prijeđi na sadržaj
Blog

Prije nego angažirate tvrtku za API integraciju u Dubaiju

Uredništvo Tekravel
Napisano uz pomoć umjetne inteligencije

Tri ponude leže na stolu. Svaka tvrtka za integraciju ima portfelj turističkih stranica, svaka obećava da će „povezati API za letove s vašom stranicom“, a najjeftinija može početi već idući tjedan. Vodite agenciju u Deiri sa šest zaposlenih i stabilnim poslovnim klijentima i dosta vam je prepisivanja cijena iz ekstraneta dobavljača u WhatsApp poruke. Odabir tvrtke za API integraciju u Dubaiju koja djeluje najkompetentnije čini se kao cijela odluka.

To je otprilike trećina odluke. Odluke o tome hoće li stranica prodavati nisu ni u jednoj od tri ponude, jer nisu kod. Riječ je o tome s kim je dobavljač potpisao ugovor, na čije se ime izdaju karte, gdje stoji novac između rezervacije i izdavanja i tko obrađuje povrat kad klijent otkaže. Integrator sve to može povezati. Ne može ništa od toga biti umjesto vas.

Ovaj tekst je za vlasnika koji će potpisati projektni zadatak, ne za programera koji će ga čitati.

Što tvrtka za API integraciju u Dubaiju može isporučiti, a što ne

Tvrtka za integraciju piše kod između API-ja dobavljača i vaše stranice: obrazac za pretragu, poziv koji traži dostupnost, provjeru cijene prije plaćanja, zahtjev za rezervaciju, zaslone koji prikazuju rezultat i, ako opseg to predviđa, pozive za otkazivanje i povrat. Dobre tvrtke rješavaju i dosadne dijelove koji su važni: ponovne pokušaje kad dobavljač ne odgovori, zapise po kojima se neuspjela rezervacija može pratiti, testno okruženje koje se ponaša kao produkcija.

Ono što vam ne može predati jest sve s druge strane tog koda. Prije prve linije agenciji treba:

  • račun kod dobavljača na vlastito ime agencije, s API pristupom dodijeljenim tom računu;
  • ovlast za izdavanje karata, bilo vlastita akreditacija ili konsolidator koji izdaje u njezino ime;
  • financijski dogovor s tim dobavljačem: polog, kreditna linija ili kartična plaćanja koja se prosljeđuju;
  • netko tko radi posao nakon izdavanja (void, povrate, ponovna izdavanja, promjene reda letenja), kroz API ili, ako to ne ide, ručno.

Integrator koji nudi da „sredi stranu dobavljača“ obično nudi da vam posudi svoju. Kao prečac za prototip to može biti razumno. Za posao znači da vaša stranica za rezervacije radi na odnosu koji ne posjedujete i ne možete ponijeti sa sobom.

Zadatak: sedam redaka za ugovor o radu

Većina sporova s integratorom svodi se na rečenicu koju nitko nije zapisao. Upišite ovo u dokument koji potpisujete, jednostavnim riječima, i tražite svaki odgovor pisano.

  1. Na čije su ime račun kod dobavljača i API ključevi. Na agenciju. Ključevi su pristupni podaci: čuvaju se u vašem upravitelju lozinki, a integrator dobiva pristup, ne vlasništvo.
  2. Tko hostira stranicu i tko drži domenu. Domena je registrirana na agenciju. Hosting račun je agencijin ili ugovor točno kaže kako se prenosi.
  3. Koje su operacije u opsegu. Nabrojite ih imenom: pretraga, cijena, rezervacija, izdavanje, otkazivanje, povrat, izmjena. Sve što nije na popisu ostaje e-mail službi dobavljača dok god stranica postoji. Povrati i izmjene najčešće nedostaju, jer ih demo nikad ne prikazuje.
  4. Tko održava kad dobavljač promijeni svoj API. Dobavljači gase verzije i preimenuju polja. Projekt po fiksnoj cijeni bez klauzule o održavanju završava onog dana kad se prva verzija promijeni.
  5. Što znači primopredaja. Izvorni kod u repozitoriju u vlasništvu agencije, svi pristupni podaci i dokument s kojim drugi programer može preuzeti posao. „Poslat ćemo vam zip“ nije primopredaja.
  6. Kako se dokazuje puštanje u rad. Testna rezervacija od pretrage do karte u testnom okruženju dobavljača, uključujući otkazivanje, prije nego netko tereti karticu stvarnog klijenta.
  7. Što se događa s podacima klijenata. Imena putnika, podaci iz putovnica i reference plaćanja: gdje se pohranjuju, tko ih može čitati i kako se brišu.

Nijedna od ovih stavki ne traži tehničko znanje da bi se napisala. Svaku je jeftinije dogovoriti prije izrade nego pregovarati poslije nje.

Tri načina da sadržaj dobavljača dođe na vašu stranicu

Angažiranje integratora prema API-ju dobavljača jedan je put. Vrijedi ga vidjeti uz druga dva prije nego što neka ponuda odluči umjesto vas.

PutTko drži odnos s dobavljačemTko održava vezu u raduŠto agencija još mora izgraditiKoliko košta odlazak
Integrator povezuje vašu stranicu s API-jem dobavljačaAgencija, ako zadatak tako kaže; inače često integratorIntegrator prema ugovoru o održavanju, ili nitkoAdmin, marže, evidencija klijenata, izvješća, plaćanja, zasloni za naknadni servisMalo ako su kod i ključevi vaši; nova izrada ako nisu
Integrator povezuje vašu stranicu s API-jem platformePlatforma drži ugovore s dobavljačima; agencija drži svoj račun na platformiPlatforma na strani dobavljača; integrator na vašoj straniVaša stranica i ono što API platforme ne pokrivaPrepisivanje vaše strane prema drugom API-ju
White-label trgovina koja je već povezanaPlatforma, preko računa agencijePlatformaSadržaj, odluke o cijenama, vlastiti klijentiPreseljenje domene i popisa klijenata kod drugog pružatelja

Redak o kojem vrijedi raspravljati je prvi. On daje najviše kontrole i najviše vas opterećuje: svaka promjena kod dobavljača, svaka nova usluga i svaka operacija koju je prva izrada izostavila postaje novi projekt s novom ponudom.

Kako dodati pretragu na stranicu koju već imate obrađeno je u tekstu pretraga letova na postojećoj web stranici, a čiji API stoji iza nje u tekstu što stoji iza pružatelja API-ja za rezervaciju letova. Ovaj tekst govori o ugovoru oko posla.

Gdje stoji ova platforma

Platforma iza ovog bloga nudi API-je za letove i hotele. Pristup počinje razgovorom, a ne samoposlužnim ključem, jer su prva pitanja ona gore (koje usluge, koje tržište, kako se kreće novac), a ne koji endpoint pozvati. Usluge se aktiviraju po računu, a svaki račun ima vlastiti admin panel s vlastitim rezervacijama, klijentima, maržama i izvješćima, pa je stupac „još mora izgraditi“ u drugom retku kraći nego što izgleda.

Ako će tvrtka za integraciju graditi vašu stranu, obavite taj razgovor prije nego prihvatite ponudu, kako bi opseg opisivao API na koji će se ona stvarno spojiti. Stranica o turističkim API-jima mjesto je gdje počinje.

Koliko vas košta slab zadatak

Stranica kreće uživo. Pretraga radi, cijene izgledaju točno, a prva rezervacija stiže u četvrtak navečer. Ne može se izdati na vaše ime, jer račun kod dobavljača pripada integratoru i izdaje po njegovu dogovoru. Kartica klijenta već je terećena. Sada imate rezervaciju koju preko vlastite stranice ne možete ni izdati ni refundirati.

Ili radi godinu dana. Onda dobavljač prijeđe na novu verziju API-ja, rezervacije stanu, a integrator, čiji je ugovor po fiksnoj cijeni završio primopredajom, šalje ponudu za novi projekt. Platite, jer jedini koji razumiju kod jesu oni koji šalju ponudu.

Ili je integrator jednostavno zauzet negdje drugdje. Klijentu treba ispraviti ime na karti, operacija izmjene nikad nije bila u opsegu, a dvoje vaših zaposlenih provodi poslijepodne šaljući e-mailove službi dobavljača. Upravo onaj posao koji je stranica trebala ukloniti.

Svaki od ovih slučajeva jedna je rečenica koja je nedostajala u zadatku. Kod je svaki put bio u redu.

Uredništvo Tekravel

Desk za putničke tehnologije

Desk za putničke tehnologije Tekravela piše za struku: vlasnike agencija, konsolidatore i programere koji ih integriraju. Svaki se članak prije objave provjerava na platformi koju opisuje.