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

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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
| Út | Kié a beszállítói kapcsolat | Ki tartja működésben a kapcsolatot | Mit kell az irodának még megépítenie | Mibe kerül a váltás |
|---|---|---|---|---|
| Integrátor köti össze az oldalt a beszállító API-jával | Az 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 senki | Admin, árrések, ügyfélnyilvántartás, riportok, fizetés, utómunka-képernyők | Kevé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ával | A platformé a beszállítói szerződés; az irodáé a fiók a platformon | A platform a beszállítói oldalon; az integrátor az ön oldalán | Az ön oldala, és amit a platform API-ja nem fed le | Az ön oldalának átírása egy másik API-ra |
| Már bekötött white-label webáruház | A platform, az iroda fiókján keresztül | A platform | Tartalom, árazási döntések, saját ügyfelek | A 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.