Înainte să angajezi o firmă de integrare API în Dubai

Ai trei oferte pe birou. Fiecare firmă de integrare are un portofoliu de site-uri de turism, fiecare promite să „conecteze un API de zboruri la site-ul tău”, iar cea mai ieftină poate începe săptămâna viitoare. Ai o agenție în Deira, șase angajați și un portofoliu corporate stabil, și te-ai săturat să copiezi tarife din extranetul furnizorului în mesaje pe WhatsApp. Alegerea firmei de integrare API în Dubai care pare cea mai competentă pare a fi toată decizia.
E cam o treime din ea. Ce decide dacă site-ul vinde nu e în niciuna dintre cele trei oferte, pentru că nu e cod. E vorba despre cu cine a fost semnat contractul cu furnizorul, pe numele cui se emit biletele, unde stau banii între rezervare și emitere și cine se ocupă de rambursare când clientul anulează. Un integrator poate lega toate acestea între ele. Nu poate fi niciuna dintre ele în locul tău.
Textul e scris pentru proprietarul care va semna caietul de sarcini, nu pentru programatorul care îl va citi.
Ce poate livra o firmă de integrare API în Dubai și ce nu
O firmă de integrare scrie codul dintre API-ul unui furnizor și site-ul tău: formularul de căutare, apelul care cere disponibilitatea, verificarea prețului înainte de plată, cererea de rezervare, ecranele care arată rezultatul și, dacă sunt în contract, apelurile de anulare și rambursare. Firmele bune se ocupă și de partea plictisitoare care contează: reîncercări când furnizorul nu răspunde la timp, loguri care permit urmărirea unei rezervări eșuate, un mediu de test care se comportă ca producția.
Ce nu îți poate da este tot ce se află de cealaltă parte a acestui cod. Înainte de primul rând scris, agenția are nevoie de:
- un cont la furnizor pe numele agenției, cu acces la API acordat acelui cont;
- drept de emitere: acreditare proprie sau un consolidator care emite în numele ei;
- o înțelegere financiară cu acel furnizor: un depozit, o linie de credit sau plăți cu cardul transmise mai departe;
- cineva care face munca de după emitere (void-uri, rambursări, reemiteri, schimbări de orar), prin API sau, dacă nu se poate, manual.
Integratorul care se oferă „să rezolve partea cu furnizorul” îți oferă de obicei să ți-o împrumute pe a lui. Pentru un prototip, poate fi o scurtătură rezonabilă. Pentru o afacere, înseamnă că site-ul tău de rezervări funcționează pe o relație care nu e a ta și pe care nu o iei cu tine când pleci.
Brieful: șapte rânduri pentru caietul de sarcini
Cele mai multe dispute cu un integrator pornesc de la o frază pe care n-a scris-o nimeni. Pune-le pe acestea în documentul pe care îl semnezi, în cuvinte simple, și cere fiecare răspuns în scris.
- Pe numele cui sunt contul la furnizor și cheile API. Pe al agenției. Cheile sunt credențiale: stau în seiful tău de parole, iar integratorul primește acces, nu proprietate.
- Cine găzduiește site-ul și cine deține domeniul. Domeniul e înregistrat pe agenție. Contul de găzduire e al agenției sau contractul spune exact cum se transferă.
- Ce operațiuni intră în contract. Enumeră-le pe nume: căutare, preț, rezervare, emitere, anulare, rambursare, modificare. Ce nu e pe listă rămâne, cât timp există site-ul, un e-mail către biroul furnizorului. Rambursările și modificările lipsesc cel mai des, pentru că nicio demonstrație nu le arată.
- Cine întreține integrarea când furnizorul își schimbă API-ul. Furnizorii retrag versiuni și redenumesc câmpuri. Un proiect la preț fix fără clauză de mentenanță se termină în ziua în care se schimbă prima versiune.
- Ce înseamnă predarea. Codul sursă într-un repository al agenției, toate credențialele și o documentație cu care alt programator poate prelua lucrul. „Vă trimitem un zip” nu e predare.
- Cum se dovedește că site-ul poate intra în producție. O rezervare de test de la căutare la bilet în mediul de test al furnizorului, inclusiv o anulare, înainte ca cineva să încaseze cardul unui client real.
- Ce se întâmplă cu datele clienților. Numele pasagerilor, datele din pașaport și referințele de plată: unde sunt stocate, cine le poate citi și cum sunt șterse.
Niciunul dintre aceste puncte nu cere pregătire tehnică. Fiecare e mai ieftin de stabilit înainte de construcție decât de negociat după.
Trei căi prin care conținutul furnizorilor ajunge pe site-ul tău
Să angajezi un integrator pe API-ul unui furnizor e o cale. Merită văzută lângă celelalte două înainte ca o ofertă să aleagă în locul tău.
| Calea | Cine deține relația cu furnizorul | Cine ține conexiunea funcțională | Ce mai are agenția de construit | Cât costă plecarea |
|---|---|---|---|---|
| Integratorul leagă site-ul tău de API-ul unui furnizor | Agenția, dacă brieful o spune; altfel, adesea integratorul | Integratorul, pe un contract de mentenanță, sau nimeni | Panou de administrare, adaosuri, evidența clienților, rapoarte, plăți, ecrane de post-vânzare | Puțin, dacă codul și cheile sunt ale tale; o reconstrucție, dacă nu |
| Integratorul leagă site-ul tău de API-ul unei platforme | Platforma are contractele cu furnizorii; agenția are contul pe platformă | Platforma pe partea furnizorului; integratorul pe partea ta | Site-ul tău și ce nu acoperă API-ul platformei | Rescrierea părții tale pe alt API |
| Magazin white-label deja conectat | Platforma, prin contul agenției | Platforma | Conținut, decizii de preț, propriii clienți | Mutarea domeniului și a listei de clienți la alt furnizor |
Rândul despre care merită discutat e primul. Dă cel mai mult control și pune cel mai mult pe umerii tăi: fiecare schimbare a furnizorului, fiecare serviciu nou și fiecare operațiune lăsată pe dinafară la prima construcție devine alt proiect, cu altă ofertă.
Cum adaugi căutarea pe un site pe care îl ai deja e discutat în adăugarea căutării de zboruri pe un site existent, iar al cui API să stea în spatele ei, în ce se află în spatele unui furnizor de API pentru rezervări de zboruri. Acest text e despre contractul din jurul muncii.
Unde se află această platformă
Platforma din spatele acestui blog oferă API-uri de zboruri și de hoteluri. Accesul începe cu o discuție, nu cu o cheie generată singur, pentru că primele întrebări sunt cele de mai sus (ce servicii, ce piață, cum circulă banii), nu ce endpoint să apelezi. Serviciile se activează pe fiecare cont, iar fiecare cont are propriul panou de administrare, cu propriile rezervări, clienți, adaosuri și rapoarte, așa că coloana „mai are de construit” din al doilea rând e mai scurtă decât pare.
Dacă partea ta o va construi o firmă de integrare, poartă această discuție înainte să accepți o ofertă, ca să descrie contractul API-ul la care se va conecta de fapt. Totul pornește de la pagina despre API-urile de turism.
Cât te costă un brief slab
Site-ul intră online. Căutarea merge, prețurile par corecte, iar prima rezervare vine joi seara. Biletul nu poate fi emis pe numele agenției tale, pentru că contul la furnizor e al integratorului și emite prin înțelegerea lui. Cardul clientului a fost deja debitat. Acum ai o rezervare pe care nu o poți nici emite, nici rambursa prin propriul site.
Sau merge un an. Apoi furnizorul trece la o versiune nouă de API, rezervările se opresc, iar integratorul, al cărui contract la preț fix s-a încheiat la predare, îți trimite oferta pentru un proiect nou. O plătești, pentru că singurii care înțeleg codul sunt cei care fac oferta.
Sau integratorul e pur și simplu ocupat cu altceva. Un client are nevoie de corectarea numelui pe bilet, operațiunea de modificare n-a intrat niciodată în contract, iar doi dintre angajații tăi își petrec după-amiaza scriind e-mailuri biroului furnizorului. Exact munca de care site-ul trebuia să vă scape.
De fiecare dată a lipsit o frază din brief. Codul a fost în regulă de fiecare dată.