Voordat je een API-integratiebedrijf in Dubai inhuurt

Er liggen drie offertes op tafel. Elk integratiebedrijf heeft een portfolio met reissites, elk belooft "een vlucht-API aan je website te koppelen", en de goedkoopste kan volgende week beginnen. Je hebt een reisbureau in Deira met zes medewerkers en een vaste zakelijke klantenkring, en je bent het zat om tarieven uit het extranet van een leverancier over te typen in WhatsApp-berichten. Het API-integratiebedrijf in Dubai kiezen dat het bekwaamst oogt, voelt als de hele beslissing.
Het is ongeveer een derde ervan. Wat bepaalt of de site verkoopt, staat in geen van de drie offertes, want het is geen code. Het gaat erom met wie het leverancierscontract is getekend, op wiens naam de tickets worden uitgegeven, waar het geld staat tussen boeking en ticketing, en wie de terugbetaling regelt als een klant annuleert. Een integrator kan dat allemaal aan elkaar knopen. Hij kan het niet voor jou zíjn.
Dit stuk is voor de eigenaar die de opdrachtomschrijving tekent, niet voor de ontwikkelaar die haar leest.
Wat een API-integratiebedrijf in Dubai kan leveren, en wat niet
Een integratiebedrijf schrijft de code tussen de API van een leverancier en je website: het zoekformulier, de aanroep die beschikbaarheid opvraagt, de prijscontrole vóór de betaling, het boekingsverzoek, de schermen met het resultaat en, als de scope het noemt, de aanroepen voor annuleren en terugbetalen. De goede bedrijven regelen ook het saaie werk dat ertoe doet: opnieuw proberen als een leverancier niet op tijd antwoordt, logs waarmee je een mislukte boeking kunt terugvinden, een testomgeving die zich gedraagt als productie.
Wat het je niet kan geven, is alles aan de andere kant van die code. Voordat er een regel geschreven wordt, heeft het bureau nodig:
- een leveranciersaccount op naam van het bureau zelf, met API-toegang voor dat account;
- ticketingbevoegdheid: een eigen accreditatie of een consolidator die namens het bureau uitgeeft;
- een financiële afspraak met die leverancier: een borg, een kredietlijn of doorgegeven kaartbetalingen;
- iemand die het werk na het ticket doet (voids, terugbetalingen, heruitgiftes, schemawijzigingen), via de API of, als dat niet kan, met de hand.
Een integrator die aanbiedt "de leverancierskant wel even te regelen", biedt meestal aan je de zijne te lenen. Voor een prototype kan dat een redelijke shortcut zijn. Voor een bedrijf betekent het dat je boekingssite draait op een relatie die niet van jou is en die je niet meeneemt als je vertrekt.
De briefing: zeven regels voor de opdrachtomschrijving
De meeste conflicten met een integrator gaan terug op een zin die niemand heeft opgeschreven. Zet deze in het document dat je tekent, in gewone taal, en vraag elk antwoord schriftelijk.
- Op wiens naam het leveranciersaccount en de API-sleutels staan. Op die van het bureau. Sleutels zijn inloggegevens: ze staan in jouw wachtwoordkluis, en de integrator krijgt toegang, geen eigendom.
- Wie de site host en wie het domein bezit. Het domein staat op naam van het bureau. Het hostingaccount is van het bureau, of het contract zegt precies hoe het wordt overgedragen.
- Welke handelingen binnen de scope vallen. Noem ze bij naam: zoeken, prijs, boeken, ticketen, annuleren, terugbetalen, wijzigen. Wat niet op de lijst staat, blijft zolang de site bestaat een e-mail aan de balie van de leverancier. Terugbetalingen en wijzigingen ontbreken het vaakst, omdat geen demo ze laat zien.
- Wie het onderhoudt als de leverancier zijn API wijzigt. Leveranciers schaffen versies af en hernoemen velden. Een bouw voor een vaste prijs zonder onderhoudsclausule houdt op te werken op de dag dat de eerste versie verandert.
- Wat overdracht betekent. Broncode in een repository van het bureau, alle inloggegevens, en documentatie waarmee een andere ontwikkelaar het werk kan overnemen. "We sturen je een zip" is geen overdracht.
- Hoe livegang wordt bewezen. Een testboeking van zoeken tot ticket in de testomgeving van de leverancier, inclusief een annulering, voordat iemand de kaart van een echte klant belast.
- Wat er met klantgegevens gebeurt. Namen van passagiers, paspoortgegevens en betaalreferenties: waar ze worden opgeslagen, wie ze kan lezen en hoe ze worden verwijderd.
Voor geen van deze punten heb je een technische achtergrond nodig. Elk ervan is goedkoper om vóór de bouw af te spreken dan erna uit te onderhandelen.
Drie routes om leverancierscontent op je site te krijgen
Een integrator inhuren tegen de API van een leverancier is één route. Het loont om die naast de andere twee te zetten voordat een offerte de keuze voor je maakt.
| Route | Wie houdt de leveranciersrelatie | Wie houdt de koppeling werkend | Wat het bureau nog moet bouwen | Wat vertrekken kost |
|---|---|---|---|---|
| Integrator koppelt je site aan de API van een leverancier | Het bureau, als de briefing dat zegt; anders vaak de integrator | De integrator onder een onderhoudscontract, of niemand | Beheer, markups, klantgegevens, rapportages, betalingen, nazorgschermen | Weinig als code en sleutels van jou zijn; opnieuw bouwen als dat niet zo is |
| Integrator koppelt je site aan de API van een platform | Het platform heeft de leverancierscontracten; het bureau heeft zijn account bij het platform | Het platform aan leverancierskant; de integrator aan jouw kant | Je site, en wat de API van het platform niet afdekt | Jouw kant herschrijven tegen een andere API |
| White-label webwinkel die al gekoppeld is | Het platform, via het account van het bureau | Het platform | Content, prijsbeslissingen, je eigen klanten | Het domein en de klantenlijst naar een andere aanbieder verhuizen |
De rij waarover je moet doorpraten is de eerste. Die geeft de meeste controle en legt het meeste bij jou: elke wijziging bij de leverancier, elke nieuwe dienst en elke handeling die de eerste bouw oversloeg, wordt een nieuw project met een nieuwe offerte.
Hoe je zoeken toevoegt aan een site die je al hebt, staat in vluchten zoeken toevoegen aan een bestaande website, en wiens API je daarachter zet in wat er achter een aanbieder van een vluchtboekings-API zit. Dit stuk gaat over het contract rond het werk.
Waar dit platform staat
Het platform achter deze blog biedt API's voor vluchten en hotels. Toegang begint met een gesprek in plaats van een sleutel die je zelf aanmaakt, omdat de eerste vragen die van hierboven zijn (welke diensten, welke markt, hoe het geld loopt) en niet welk endpoint je aanroept. Diensten worden per account geactiveerd, en elk account heeft een eigen beheerpaneel met eigen boekingen, klanten, markups en rapportages, dus de kolom "nog bouwen" in de tweede rij is korter dan hij lijkt.
Gaat een integratiebedrijf jouw kant bouwen, voer dat gesprek dan voordat je een offerte accepteert, zodat de scope de API beschrijft waarmee het echt gaat koppelen. De pagina over reis-API's is waar het begint.
Wat een zwakke briefing je kost
De site gaat live. Zoeken werkt, de prijzen kloppen, en de eerste boeking komt binnen op een donderdagavond. Die kan niet op naam van je bureau worden geticket, want het leveranciersaccount is van de integrator en geeft uit onder diens afspraak. De kaart van de klant is al belast. Nu heb je een boeking die je via je eigen site niet kunt ticketen en niet kunt terugbetalen.
Of het werkt een jaar. Dan stapt de leverancier over op een nieuwe API-versie, boeken stopt, en de integrator, wiens contract voor een vaste prijs eindigde bij de overdracht, stuurt een offerte voor een nieuw project. Je betaalt, want de enigen die de code begrijpen, zijn degenen die de offerte sturen.
Of de integrator heeft het gewoon druk met iets anders. Een klant moet een naam op een ticket laten corrigeren, de wijzigingshandeling zat nooit in de scope, en twee van je medewerkers zijn de hele middag bezig met e-mails aan de leveranciersbalie. Precies het werk dat de site je uit handen had moeten nemen.
Elke keer ontbrak er één zin in de briefing. De code was elke keer in orde.