Ugrás a tartalomra
Blog

Mielőtt API-integrációs céget bíz meg Dubajban

Tekravel Szerkesztőség
Mesterséges intelligencia segítségével írva

Három árajánlat fekszik az asztalon. Mindhárom integrációs cégnek van portfóliója utazási oldalakból, mindhárom megígéri, hogy „összeköt egy repülőjegy-API-t az ön weboldalával”, és a legolcsóbb már jövő héten kezdhet. Ön egy hatfős irodát vezet Deirában, stabil vállalati ügyfélkörrel, és elege van abból, hogy egy beszállítói extranetről WhatsApp-üzenetekbe gépeli át az árakat. Úgy érzi, a legrátermettebbnek tűnő dubaji API-integrációs cég kiválasztása maga a döntés.

Valójában csak körülbelül a harmada. Azok a döntések, amelyektől az oldal eladni kezd, egyik ajánlatban sincsenek benne, mert nem kódról szólnak. Arról szólnak, kivel szerződött a beszállító, kinek a nevén állítják ki a jegyeket, hol van a pénz a foglalás és a jegykiállítás között, és ki intézi a visszatérítést, amikor egy ügyfél lemond. Egy integrátor mindezt össze tudja kötni. Egyik sem lehet ön helyett.

Ez a szöveg annak a tulajdonosnak szól, aki aláírja a feladatleírást, nem a fejlesztőnek, aki elolvassa.

Mit tud szállítani egy dubaji API-integrációs cég, és mit nem

Egy integrációs cég a beszállító API-ja és az ön weboldala közötti kódot írja meg: a keresőűrlapot, az elérhetőséget lekérdező hívást, a fizetés előtti árellenőrzést, a foglalási kérést, az eredményt mutató képernyőket, és ha a terjedelem így szól, a lemondó és visszatérítő hívásokat is. A jók a fontos, de unalmas részeket is megcsinálják: újrapróbálkozást, ha a beszállító nem válaszol, naplókat, amelyekből egy sikertelen foglalás visszakövethető, és olyan tesztkörnyezetet, amely úgy viselkedik, mint az éles.

Amit nem tud átadni, az minden, ami a kód túloldalán van. Mielőtt egyetlen sor elkészül, az irodának szüksége van:

  • egy beszállítói fiókra az iroda saját nevén, ehhez a fiókhoz rendelt API-hozzáféréssel;
  • jegykiállítási jogra, akár saját akkreditációval, akár egy konszolidátorral, aki az iroda nevében állít ki;
  • egy pénzügyi megállapodásra a beszállítóval: letét, hitelkeret vagy továbbított kártyás fizetés;
  • valakire, aki elvégzi a kiállítás utáni munkát (void, visszatérítés, újrakiállítás, menetrendváltozás), az API-n keresztül vagy, ha az nem megy, kézzel.

Az az integrátor, aki felajánlja, hogy „elintézi a beszállítói oldalt”, általában a sajátját kölcsönözné önnek. Egy prototípushoz ez ésszerű rövidítés lehet. Egy vállalkozásnál azt jelenti, hogy a foglalási oldala egy olyan kapcsolaton fut, amely nem az öné, és amelyet nem vihet magával.

A brief: hét sor a feladatleírásba

Az integrátorral folytatott viták többsége egy olyan mondatra vezethető vissza, amelyet senki nem írt le. Írja bele ezeket az aláírandó dokumentumba, egyszerű szavakkal, és minden választ kérjen írásban.

  1. Kinek a nevén van a beszállítói fiók és az API-kulcsok. Az irodáén. A kulcsok hozzáférési adatok: az ön jelszókezelőjében vannak, az integrátor hozzáférést kap, nem tulajdonjogot.
  2. Ki üzemelteti az oldalt, és kié a domain. A domain az iroda nevére van bejegyezve. A tárhelyfiók az irodáé, vagy a szerződés pontosan leírja, hogyan száll át.
  3. Mely műveletek tartoznak a terjedelembe. Sorolja fel név szerint: keresés, árazás, foglalás, jegykiállítás, lemondás, visszatérítés, módosítás. Ami nincs a listán, az az oldal teljes élettartama alatt e-mail marad a beszállító ügyfélszolgálatának. A visszatérítés és a módosítás hiányzik a leggyakrabban, mert egy demó soha nem mutatja meg őket.
  4. Ki tartja karban, amikor a beszállító megváltoztatja az API-t. A beszállítók kivezetnek verziókat és átneveznek mezőket. Egy fix áras projekt karbantartási záradék nélkül azon a napon ér véget, amikor az első verzió megváltozik.
  5. Mit jelent az átadás. Forráskód egy, az iroda tulajdonában lévő repositoryban, minden hozzáférési adat, és egy dokumentum, amelyből egy másik fejlesztő átveheti a munkát. A „küldünk egy zipet” nem átadás.
  6. Hogyan bizonyítják az élesítést. Egy tesztfoglalás a kereséstől a jegyig a beszállító tesztkörnyezetében, lemondással együtt, mielőtt bárki megterhelné egy valódi ügyfél kártyáját.
  7. Mi történik az ügyféladatokkal. Utasnevek, útlevéladatok és fizetési hivatkozások: hol tárolják őket, ki olvashatja, és hogyan törlik.

Egyik megírásához sem kell műszaki háttér. Mindegyiket olcsóbb a fejlesztés előtt rögzíteni, mint utána tárgyalni róla.

Három út a beszállítói tartalomhoz az ön oldalán

Integrátort fogadni egy beszállító API-jához az egyik út. Érdemes a másik kettő mellé tenni, mielőtt egy árajánlat dönt ön helyett.

ÚtKié a beszállítói kapcsolatKi tartja működésben a kapcsolatotMit kell az irodának még megépítenieMibe kerül a váltás
Integrátor köti össze az oldalt a beszállító API-jávalAz irodáé, ha a brief így szól; különben gyakran az integrátoréAz integrátor karbantartási szerződés alapján, vagy senkiAdmin, árrések, ügyfélnyilvántartás, riportok, fizetés, utómunka-képernyőkKevés, ha a kód és a kulcsok az öné; újraépítés, ha nem
Integrátor köti össze az oldalt egy platform API-jávalA platformé a beszállítói szerződés; az irodáé a fiók a platformonA platform a beszállítói oldalon; az integrátor az ön oldalánAz ön oldala, és amit a platform API-ja nem fed leAz ön oldalának átírása egy másik API-ra
Már bekötött white-label webáruházA platform, az iroda fiókján keresztülA platformTartalom, árazási döntések, saját ügyfelekA domain és az ügyféllista átvitele egy másik szolgáltatóhoz

Az első soron érdemes vitatkozni. Ez adja a legtöbb kontrollt, és ez rak a legtöbbet önre: minden beszállítói változás, minden új szolgáltatás és minden művelet, amely az első fejlesztésből kimaradt, újabb projekt lesz újabb árajánlattal.

Hogy miként kerül keresés egy már működő oldalra, arról a repülőjegy-kereső egy meglévő weboldalon szól, arról pedig, kinek az API-ja álljon mögötte, a mi áll egy repülőjegy-foglalási API szolgáltató mögött. Ez a cikk a munka körüli szerződésről szól.

Hol áll ez a platform

A blog mögötti platform repülőjegy- és szálloda-API-kat kínál. A hozzáférés beszélgetéssel indul, nem önkiszolgáló kulccsal, mert az első kérdések a fentiek (mely szolgáltatások, melyik piac, hogyan mozog a pénz), nem pedig az, hogy melyik végpontot kell hívni. A szolgáltatásokat fiókonként aktiválják, és minden fióknak saját adminfelülete van saját foglalásokkal, ügyfelekkel, árrésekkel és riportokkal, így a második sor „még megépítendő” oszlopa rövidebb, mint amilyennek látszik.

Ha egy integrációs cég építi meg az ön oldalát, folytassa le ezt a beszélgetést, mielőtt elfogad egy ajánlatot, hogy a terjedelem azt az API-t írja le, amelyhez valóban csatlakozni fog. Az utazási API-k oldala a kiindulópont.

Mibe kerül egy gyenge brief

Az oldal élesbe megy. A keresés működik, az árak jónak tűnnek, és az első foglalás egy csütörtök este érkezik. Nem állítható ki az ön nevén, mert a beszállítói fiók az integrátoré, és az ő megállapodásuk alapján állít ki. Az ügyfél kártyáját már megterhelték. Most van egy foglalása, amelyet a saját oldalán keresztül sem kiállítani, sem visszatéríteni nem tud.

Vagy egy évig működik. Aztán a beszállító új API-verzióra vált, a foglalás leáll, és az integrátor, akinek fix áras szerződése az átadással véget ért, ajánlatot ad egy új projektre. Ön kifizeti, mert csak azok értik a kódot, akik az ajánlatot adják.

Vagy az integrátor egyszerűen máshol van elfoglalva. Egy ügyfélnek javítani kell a nevét a jegyen, a módosítás művelete soha nem volt a terjedelemben, és két munkatársa a délutánt egy beszállítói ügyfélszolgálatnak írt e-mailekkel tölti. Pontosan azt a munkát, amelyet az oldalnak kellett volna elvennie.

Mindegyik egyetlen mondat, amely hiányzott a briefből. A kód minden alkalommal rendben volt.

Tekravel Szerkesztőség

Utazástechnológiai rovat

A Tekravel utazástechnológiai rovata a szakmának ír: irodatulajdonosoknak, konszolidátoroknak és az őket integráló fejlesztőknek. Minden cikket a leírt platformon ellenőrzünk a megjelenés előtt.