Ennen kuin palkkaat API-integraatioyrityksen Dubaissa

Pöydällä on kolme tarjousta. Jokaisella integraatioyrityksellä on portfolio matkailusivustoja, jokainen lupaa ”liittää lento-API:n sivustoosi”, ja halvin pääsee aloittamaan ensi viikolla. Pyörität matkatoimistoa Deirassa, sinulla on kuusi työntekijää ja vakaa yritysasiakaskunta, ja olet kyllästynyt kirjoittamaan hintoja toimittajan extranetistä WhatsApp-viesteihin. Pätevimmältä näyttävän API-integraatioyrityksen valitseminen Dubaissa tuntuu koko päätökseltä.
Se on noin kolmasosa siitä. Se, mikä ratkaisee, myykö sivusto, ei ole yhdessäkään kolmesta tarjouksesta, koska se ei ole koodia. Kyse on siitä, kenen kanssa toimittajasopimus on tehty, kenen nimissä liput kirjoitetaan, missä rahat ovat varauksen ja lipun kirjoittamisen välissä ja kuka hoitaa palautuksen, kun asiakas peruu. Integraattori voi kytkeä kaiken tämän yhteen. Se ei voi olla mitään näistä sinun puolestasi.
Tämä teksti on kirjoitettu omistajalle, joka allekirjoittaa työn määrittelyn, ei kehittäjälle, joka sen lukee.
Mitä API-integraatioyritys Dubaissa voi toimittaa ja mitä ei
Integraatioyritys kirjoittaa koodin toimittajan API:n ja sivustosi väliin: hakulomakkeen, saatavuutta kysyvän kutsun, hinnantarkistuksen ennen maksua, varauspyynnön, tuloksen näyttävät näkymät ja, jos määrittely niin sanoo, peruutus- ja palautuskutsut. Hyvät yritykset hoitavat myös tylsät mutta tärkeät asiat: uudelleenyritykset, kun toimittaja ei vastaa ajoissa, lokit, joista epäonnistunut varaus voidaan jäljittää, ja testiympäristön, joka käyttäytyy kuin tuotanto.
Se ei voi antaa sinulle mitään siitä, mikä on koodin toisella puolella. Ennen ensimmäistä riviä toimisto tarvitsee:
- toimittajatilin toimiston omissa nimissä, ja API-pääsyn juuri sille tilille;
- oikeuden kirjoittaa lippuja: oman akkreditoinnin tai konsolidaattorin, joka kirjoittaa toimiston puolesta;
- rahajärjestelyn toimittajan kanssa: vakuustalletuksen, luottorajan tai edelleen välitettävät korttimaksut;
- jonkun, joka tekee lipun jälkeisen työn (voidit, palautukset, uudelleenkirjoitukset, aikataulumuutokset), API:n kautta tai, jos se ei onnistu, käsin.
Integraattori, joka tarjoutuu ”hoitamaan toimittajapuolen”, tarjoutuu yleensä lainaamaan sinulle omansa. Prototyypissä se voi olla järkevä oikotie. Yritykselle se tarkoittaa, että varaussivustosi pyörii suhteen varassa, joka ei ole sinun ja jota et vie mukanasi, kun lähdet.
Brief: seitsemän riviä työn määrittelyyn
Useimmat riidat integraattorin kanssa palautuvat lauseeseen, jota kukaan ei kirjoittanut ylös. Kirjoita nämä allekirjoittamaasi asiakirjaan selkokielellä ja pyydä jokainen vastaus kirjallisena.
- Kenen nimissä toimittajatili ja API-avaimet ovat. Toimiston. Avaimet ovat tunnuksia: ne ovat sinun salasanaholvissasi, ja integraattori saa käyttöoikeuden, ei omistusta.
- Kuka hostaa sivuston ja kuka omistaa verkkotunnuksen. Verkkotunnus on rekisteröity toimistolle. Hosting-tili on toimiston, tai sopimus kertoo tarkasti, miten se siirretään.
- Mitkä toiminnot kuuluvat työhön. Luettele ne nimeltä: haku, hinta, varaus, lipun kirjoitus, peruutus, palautus, muutos. Mikä ei ole listalla, jää sivuston koko elinkaaren ajaksi sähköpostiksi toimittajan palvelutiskille. Palautukset ja muutokset puuttuvat useimmin, koska mikään demo ei näytä niitä.
- Kuka ylläpitää integraatiota, kun toimittaja muuttaa API:aan. Toimittajat poistavat versioita käytöstä ja nimeävät kenttiä uudelleen. Kiinteähintainen toteutus ilman ylläpitolauseketta päättyy sinä päivänä, kun ensimmäinen versio muuttuu.
- Mitä luovutus tarkoittaa. Lähdekoodi toimiston omistamassa repositoryssa, kaikki tunnukset ja dokumentaatio, jonka avulla toinen kehittäjä voi jatkaa työtä. ”Lähetämme zip-tiedoston” ei ole luovutus.
- Miten käyttöönotto todistetaan. Testivaraus hausta lippuun toimittajan testiympäristössä, peruutus mukaan lukien, ennen kuin kukaan veloittaa oikean asiakkaan korttia.
- Mitä asiakastiedoille tapahtuu. Matkustajien nimet, passitiedot ja maksuviitteet: missä ne säilytetään, kuka voi lukea niitä ja miten ne poistetaan.
Mikään näistä ei vaadi teknistä taustaa. Jokainen on halvempi sopia ennen rakentamista kuin neuvotella jälkikäteen.
Kolme tapaa saada toimittajien sisältö sivustollesi
Integraattorin palkkaaminen toimittajan API:a vasten on yksi tapa. Se kannattaa nähdä kahden muun rinnalla ennen kuin tarjous tekee valinnan puolestasi.
| Tapa | Kenellä on toimittajasuhde | Kuka pitää yhteyden toiminnassa | Mitä toimiston on vielä rakennettava | Mitä lähteminen maksaa |
|---|---|---|---|---|
| Integraattori liittää sivustosi toimittajan API:in | Toimistolla, jos brief niin sanoo; muuten usein integraattorilla | Integraattori ylläpitosopimuksella, tai ei kukaan | Hallinta, katteet, asiakasrekisteri, raportit, maksut, jälkimyynnin näkymät | Vähän, jos koodi ja avaimet ovat sinun; uudelleenrakentaminen, jos eivät ole |
| Integraattori liittää sivustosi alustan API:in | Alustalla on toimittajasopimukset; toimistolla on tilinsä alustalla | Alusta toimittajan puolella; integraattori sinun puolellasi | Sivustosi ja se, mitä alustan API ei kata | Oman puolesi uudelleenkirjoittaminen toista API:a vasten |
| Valmiiksi liitetty white-label-verkkokauppa | Alusta, toimiston tilin kautta | Alusta | Sisältö, hinnoittelupäätökset, omat asiakkaasi | Verkkotunnuksen ja asiakaslistan siirto toiselle palveluntarjoajalle |
Väittelemisen arvoinen rivi on ensimmäinen. Se antaa eniten hallintaa ja sälyttää eniten sinulle: jokainen toimittajan muutos, jokainen uusi palvelu ja jokainen toiminto, joka jäi ensimmäisestä toteutuksesta pois, muuttuu uudeksi projektiksi ja uudeksi tarjoukseksi.
Miten haku lisätään jo olemassa olevalle sivustolle, käsitellään tekstissä lentohaun lisääminen olemassa olevalle sivustolle, ja kenen API sen taakse kannattaa valita, tekstissä mitä lentovaraus-API:n toimittajan takana on. Tämä teksti käsittelee työn ympärillä olevaa sopimusta.
Missä tämä alusta on
Tämän blogin takana oleva alusta tarjoaa API:t lennoille ja hotelleille. Pääsy alkaa keskustelulla eikä itse luotavalla avaimella, koska ensimmäiset kysymykset ovat yllä olevat (mitkä palvelut, mikä markkina, miten rahat liikkuvat) eivätkä se, mitä endpointia kutsutaan. Palvelut aktivoidaan tilikohtaisesti, ja jokaisella tilillä on oma hallintapaneeli omine varauksineen, asiakkaineen, katteineen ja raportteineen, joten toisen rivin ”on vielä rakennettava” -sarake on lyhyempi kuin miltä se näyttää.
Jos integraatioyritys rakentaa sinun puolesi, käy tämä keskustelu ennen kuin hyväksyt tarjouksen, jotta määrittely kuvaa sitä API:a, johon se oikeasti liitetään. Matkailun API-sivu on paikka aloittaa.
Mitä heikko brief maksaa
Sivusto julkaistaan. Haku toimii, hinnat näyttävät oikeilta, ja ensimmäinen varaus tulee torstai-iltana. Lippua ei voi kirjoittaa toimistosi nimissä, koska toimittajatili kuuluu integraattorille ja kirjoittaa tämän sopimuksella. Asiakkaan korttia on jo veloitettu. Nyt sinulla on varaus, jota et voi oman sivustosi kautta kirjoittaa etkä palauttaa.
Tai se toimii vuoden. Sitten toimittaja siirtyy uuteen API-versioon, varaukset pysähtyvät, ja integraattori, jonka kiinteähintainen sopimus päättyi luovutukseen, tekee tarjouksen uudesta projektista. Maksat, koska ainoat, jotka ymmärtävät koodin, ovat tarjouksen tekijät.
Tai integraattori on yksinkertaisesti kiireinen muualla. Asiakkaan nimi pitää korjata lippuun, muutostoiminto ei koskaan kuulunut työhön, ja kaksi työntekijääsi käyttää iltapäivän sähköpostitteluun toimittajan palvelutiskin kanssa. Juuri sitä työtä sivuston piti viedä pois.
Joka kerta briefistä puuttui yksi lause. Koodi oli joka kerta kunnossa.