Innan du anlitar ett API-integrationsföretag i Dubai

Tre offerter ligger på bordet. Varje integrationsföretag har en portfölj med resesajter, alla lovar att ”koppla ett flyg-API till din webbplats”, och det billigaste kan börja nästa vecka. Du driver en resebyrå i Deira med sex anställda och en stadig företagskundbas, och du är trött på att skriva av priser från leverantörens extranät till WhatsApp-meddelanden. Att välja det API-integrationsföretag i Dubai som ser mest kompetent ut känns som hela beslutet.
Det är ungefär en tredjedel av det. Det som avgör om sajten säljer finns inte i någon av de tre offerterna, eftersom det inte är kod. Det handlar om vem leverantörsavtalet är tecknat med, i vems namn biljetterna utfärdas, var pengarna ligger mellan bokning och utfärdande, och vem som sköter återbetalningen när en kund avbokar. En integratör kan koppla ihop allt detta. Den kan inte vara något av det åt dig.
Texten är skriven för ägaren som ska skriva under uppdragsbeskrivningen, inte för utvecklaren som ska läsa den.
Vad ett API-integrationsföretag i Dubai kan leverera, och vad det inte kan
Ett integrationsföretag skriver koden mellan en leverantörs API och din webbplats: sökformuläret, anropet som frågar efter tillgänglighet, priskontrollen före betalning, bokningsförfrågan, vyerna som visar resultatet och, om uppdraget säger det, anropen för avbokning och återbetalning. De bra företagen tar också hand om det tråkiga som spelar roll: nya försök när leverantören inte svarar i tid, loggar som gör att en misslyckad bokning kan spåras, en testmiljö som beter sig som produktionen.
Det som inte går att få av dem är allt som ligger på andra sidan koden. Innan första raden skrivs behöver byrån:
- ett leverantörskonto i byråns eget namn, med API-åtkomst kopplad till just det kontot;
- behörighet att utfärda biljetter: egen ackreditering eller en konsolidator som utfärdar för byråns räkning;
- en ekonomisk överenskommelse med leverantören: en deposition, en kreditram eller kortbetalningar som förs vidare;
- någon som gör arbetet efter biljetten (voids, återbetalningar, omutfärdanden, tidtabellsändringar), via API:et eller, om det inte går, för hand.
En integratör som erbjuder sig att ”fixa leverantörssidan” erbjuder oftast att låna ut sin egen. För en prototyp kan det vara en rimlig genväg. För ett företag betyder det att bokningssajten vilar på en relation som inte är din och som du inte tar med dig när du lämnar.
Briefen: sju rader till uppdragsbeskrivningen
De flesta tvister med en integratör går tillbaka till en mening som ingen skrev ner. Skriv in de här i dokumentet du undertecknar, med vanliga ord, och be om varje svar skriftligt.
- I vems namn leverantörskontot och API-nycklarna står. Byråns. Nycklar är inloggningsuppgifter: de ligger i ditt lösenordsvalv, och integratören får åtkomst, inte äganderätt.
- Vem som driftar sajten och vem som äger domänen. Domänen är registrerad på byrån. Hostingkontot är byråns, eller så säger avtalet exakt hur det överlåts.
- Vilka operationer som ingår. Räkna upp dem: sök, pris, boka, utfärda, avboka, återbetala, ändra. Det som inte står på listan förblir ett mejl till leverantörens disk så länge sajten finns. Återbetalningar och ändringar saknas oftast, eftersom ingen demo visar dem.
- Vem som underhåller integrationen när leverantören ändrar sitt API. Leverantörer pensionerar versioner och döper om fält. Ett bygge till fast pris utan underhållsklausul tar slut den dag första versionen ändras.
- Vad överlämning betyder. Källkod i ett repository som byrån äger, alla inloggningsuppgifter och dokumentation som låter en annan utvecklare ta över. ”Vi skickar en zip-fil” är ingen överlämning.
- Hur driftstarten bevisas. En testbokning från sökning till biljett i leverantörens testmiljö, inklusive en avbokning, innan någon drar en riktig kunds kort.
- Vad som händer med kunddata. Passagerarnamn, passuppgifter och betalningsreferenser: var de lagras, vem som kan läsa dem och hur de raderas.
Inget av detta kräver teknisk bakgrund att skriva. Allt är billigare att komma överens om före bygget än att förhandla om efteråt.
Tre vägar att få leverantörsinnehåll till din sajt
Att anlita en integratör mot en leverantörs API är en väg. Den är värd att se bredvid de två andra innan en offert gör valet åt dig.
| Väg | Vem äger leverantörsrelationen | Vem håller kopplingen igång | Vad byrån fortfarande måste bygga | Vad det kostar att lämna |
|---|---|---|---|---|
| Integratören kopplar din sajt till en leverantörs API | Byrån, om briefen säger det; annars ofta integratören | Integratören under ett underhållsavtal, eller ingen | Administration, påslag, kundregister, rapporter, betalningar, vyer för eftermarknad | Lite om koden och nycklarna är dina; ett nybygge om de inte är det |
| Integratören kopplar din sajt till en plattforms API | Plattformen har leverantörsavtalen; byrån har sitt konto hos plattformen | Plattformen på leverantörssidan; integratören på din sida | Din sajt, och det plattformens API inte täcker | Att skriva om din sida mot ett annat API |
| White-label-butik som redan är kopplad | Plattformen, via byråns konto | Plattformen | Innehåll, prisbeslut, dina egna kunder | Att flytta domänen och kundlistan till en annan leverantör |
Raden att diskutera är den första. Den ger mest kontroll och lägger mest på dig: varje leverantörsändring, varje ny tjänst och varje operation som första bygget hoppade över blir ett nytt projekt med en ny offert.
Hur du lägger till sökning på en sajt du redan har tas upp i lägga till flygsökning på en befintlig webbplats, och vems API som ska stå bakom den i vad som finns bakom en leverantör av API för flygbokning. Den här texten handlar om avtalet runt arbetet.
Var den här plattformen står
Plattformen bakom den här bloggen erbjuder API:er för flyg och hotell. Åtkomst börjar med ett samtal snarare än en nyckel du skapar själv, eftersom de första frågorna är de ovan (vilka tjänster, vilken marknad, hur pengarna rör sig) och inte vilken endpoint du ska anropa. Tjänster aktiveras per konto, och varje konto har en egen adminpanel med egna bokningar, kunder, påslag och rapporter, så kolumnen ”måste fortfarande bygga” i andra raden är kortare än den ser ut.
Ska ett integrationsföretag bygga din sida, ta det samtalet innan du accepterar en offert, så att uppdraget beskriver det API det faktiskt ska kopplas mot. Sidan om rese-API:er är där det börjar.
Vad en svag brief kostar dig
Sajten går live. Sökningen fungerar, priserna ser rätt ut, och den första bokningen kommer en torsdagskväll. Den kan inte utfärdas i byråns namn, eftersom leverantörskontot tillhör integratören och utfärdar under dennes avtal. Kundens kort är redan debiterat. Nu sitter du med en bokning som du varken kan utfärda eller återbetala via din egen sajt.
Eller så fungerar det i ett år. Sedan går leverantören över till en ny API-version, bokningen stannar, och integratören, vars fastprisavtal tog slut vid överlämningen, lämnar offert på ett nytt projekt. Du betalar, eftersom de enda som förstår koden är de som lämnar offerten.
Eller så är integratören helt enkelt upptagen med annat. En kund behöver få ett namn rättat på en biljett, ändringsoperationen ingick aldrig, och två av dina anställda ägnar eftermiddagen åt att mejla leverantörens disk. Precis det arbete sajten skulle ta bort.
Varje gång saknades en mening i briefen. Koden var i ordning varje gång.