Przejdź do treści
Blog

Zanim zatrudnisz firmę od integracji API w Dubaju

Redakcja Tekravel
Napisano z pomocą AI

Na biurku leżą trzy oferty. Każda firma integracyjna ma portfolio serwisów turystycznych, każda obiecuje „podłączyć API lotów do Twojej strony”, a najtańsza może zacząć w przyszłym tygodniu. Prowadzisz biuro podróży w Deirze, masz sześciu pracowników i stałą grupę klientów firmowych, i masz dość przepisywania taryf z extranetu dostawcy do wiadomości na WhatsAppie. Wybór firmy od integracji API w Dubaju, która wygląda na najbardziej kompetentną, wydaje się całą decyzją.

To mniej więcej jedna trzecia. To, co przesądza, czy serwis sprzedaje, nie znajduje się w żadnej z trzech ofert, bo to nie jest kod. Chodzi o to, z kim podpisano umowę z dostawcą, na czyje nazwisko wystawiane są bilety, gdzie leżą pieniądze między rezerwacją a wystawieniem biletu i kto zajmie się zwrotem, gdy klient zrezygnuje. Integrator może to wszystko połączyć. Nie może być żadnym z tych elementów za Ciebie.

Ten tekst jest dla właściciela, który podpisze zakres prac, a nie dla programisty, który będzie go czytał.

Co firma od integracji API w Dubaju może dostarczyć, a czego nie

Firma integracyjna pisze kod między API dostawcy a Twoją stroną: formularz wyszukiwania, zapytanie o dostępność, sprawdzenie ceny przed płatnością, żądanie rezerwacji, ekrany z wynikiem i, jeśli zakres to przewiduje, wywołania anulowania i zwrotu. Dobre firmy dbają też o nudne rzeczy, które mają znaczenie: ponowienie zapytania, gdy dostawca nie odpowiada na czas, logi pozwalające prześledzić nieudaną rezerwację, środowisko testowe, które zachowuje się jak produkcyjne.

Nie może natomiast dać Ci niczego, co leży po drugiej stronie tego kodu. Zanim powstanie pierwsza linijka, biuro potrzebuje:

  • konta u dostawcy na własną nazwę, z dostępem do API przyznanym temu kontu;
  • uprawnień do wystawiania biletów: własnej akredytacji albo konsolidatora, który wystawia w jego imieniu;
  • ustaleń finansowych z tym dostawcą: depozytu, limitu kredytowego albo przekazywanych płatności kartą;
  • kogoś, kto wykona pracę po wystawieniu biletu (voidy, zwroty, reemisje, zmiany rozkładu), przez API, a jeśli się nie da, ręcznie.

Integrator, który proponuje, że „załatwi stronę dostawcy”, zwykle proponuje pożyczenie Ci swojej. Przy prototypie to bywa rozsądny skrót. W firmie oznacza, że Twój serwis rezerwacyjny działa na relacji, która nie należy do Ciebie i której nie zabierzesz, odchodząc.

Brief: siedem punktów do zakresu prac

Większość sporów z integratorem wraca do zdania, którego nikt nie zapisał. Wpisz te punkty do dokumentu, który podpisujesz, prostym językiem, i poproś o każdą odpowiedź na piśmie.

  1. Na kogo jest konto u dostawcy i klucze API. Na biuro. Klucze to dane dostępowe: są w Twoim sejfie haseł, a integrator dostaje dostęp, nie własność.
  2. Kto hostuje stronę i kto jest właścicielem domeny. Domena jest zarejestrowana na biuro. Konto hostingowe należy do biura albo umowa dokładnie opisuje, jak zostanie przekazane.
  3. Jakie operacje wchodzą w zakres. Wymień je z nazwy: wyszukiwanie, cena, rezerwacja, wystawienie biletu, anulowanie, zwrot, zmiana. To, czego nie ma na liście, przez całe życie serwisu pozostanie e-mailem do działu obsługi dostawcy. Najczęściej brakuje zwrotów i zmian, bo żadne demo ich nie pokazuje.
  4. Kto utrzymuje integrację, gdy dostawca zmieni API. Dostawcy wycofują wersje i zmieniają nazwy pól. Projekt za stałą cenę bez klauzuli utrzymania kończy się w dniu, w którym zmieni się pierwsza wersja.
  5. Co znaczy przekazanie. Kod źródłowy w repozytorium należącym do biura, wszystkie dane dostępowe i dokumentacja, dzięki której inny programista przejmie pracę. „Wyślemy paczkę zip” to nie przekazanie.
  6. Jak udowodnić gotowość do startu. Rezerwacja testowa od wyszukiwania do biletu w środowisku testowym dostawcy, łącznie z anulowaniem, zanim ktokolwiek obciąży kartę prawdziwego klienta.
  7. Co dzieje się z danymi klientów. Nazwiska pasażerów, dane paszportowe i referencje płatności: gdzie są przechowywane, kto może je czytać i jak są usuwane.

Żaden z tych punktów nie wymaga wykształcenia technicznego. Każdy taniej jest uzgodnić przed budową niż negocjować po niej.

Trzy sposoby, by treści dostawców trafiły na Twoją stronę

Zatrudnienie integratora do podłączenia API dostawcy to jedna droga. Warto zobaczyć ją obok dwóch pozostałych, zanim oferta wybierze za Ciebie.

DrogaKto ma relację z dostawcąKto dba o działanie połączeniaCo biuro musi jeszcze zbudowaćIle kosztuje odejście
Integrator łączy Twoją stronę z API dostawcyBiuro, jeśli brief tak mówi; inaczej często integratorIntegrator w ramach umowy serwisowej albo niktPanel, marże, kartoteka klientów, raporty, płatności, ekrany obsługi posprzedażowejNiewiele, jeśli kod i klucze są Twoje; przebudowa, jeśli nie są
Integrator łączy Twoją stronę z API platformyPlatforma ma umowy z dostawcami; biuro ma konto na platformiePlatforma po stronie dostawcy; integrator po Twojej stronieTwoją stronę i to, czego API platformy nie obejmujePrzepisanie Twojej strony pod inne API
Sklep white-label, który jest już podłączonyPlatforma, przez konto biuraPlatformaTreści, decyzje cenowe, własnych klientówPrzeniesienie domeny i listy klientów do innego dostawcy

O pierwszy wiersz warto się spierać. Daje najwięcej kontroli i najwięcej zrzuca na Ciebie: każda zmiana u dostawcy, każda nowa usługa i każda operacja pominięta przy pierwszej budowie staje się kolejnym projektem z kolejną ofertą.

Jak dodać wyszukiwarkę do strony, którą już masz, opisuje tekst wyszukiwarka lotów na istniejącej stronie, a czyje API postawić za nią — co stoi za dostawcą API rezerwacji lotów. Ten tekst dotyczy umowy wokół samej pracy.

Gdzie w tym wszystkim jest ta platforma

Platforma, która stoi za tym blogiem, udostępnia API lotów i hoteli. Dostęp zaczyna się od rozmowy, a nie od klucza wygenerowanego samodzielnie, bo pierwsze pytania to te powyżej (jakie usługi, jaki rynek, jak płyną pieniądze), a nie to, jaki endpoint wywołać. Usługi są włączane dla każdego konta osobno, a każde konto ma własny panel administracyjny z własnymi rezerwacjami, klientami, marżami i raportami, więc kolumna „co jeszcze zbudować” w drugim wierszu jest krótsza, niż się wydaje.

Jeśli Twoją stronę ma budować firma integracyjna, przeprowadź tę rozmowę przed przyjęciem oferty, żeby zakres opisywał API, z którym naprawdę się połączy. Zacznij od strony o API dla turystyki.

Ile kosztuje słaby brief

Serwis rusza. Wyszukiwanie działa, ceny wyglądają dobrze, a pierwsza rezerwacja przychodzi w czwartek wieczorem. Nie da się wystawić biletu na nazwę Twojego biura, bo konto u dostawcy należy do integratora i wystawia w ramach jego umowy. Karta klienta jest już obciążona. Masz rezerwację, której przez własny serwis nie możesz ani wystawić, ani zwrócić.

Albo działa przez rok. Potem dostawca przechodzi na nową wersję API, rezerwacje stają, a integrator, którego umowa za stałą cenę skończyła się przy przekazaniu, wycenia nowy projekt. Płacisz, bo jedyni ludzie, którzy rozumieją kod, to ci, którzy wyceniają.

Albo integrator jest po prostu zajęty czymś innym. Klient musi poprawić nazwisko na bilecie, operacja zmiany nigdy nie weszła w zakres, a dwoje Twoich pracowników spędza popołudnie na mailach do działu obsługi dostawcy. Dokładnie tę pracę serwis miał Wam zdjąć z głowy.

Za każdym razem w briefie brakowało jednego zdania. Kod był za każdym razem w porządku.

Redakcja Tekravel

Dział technologii turystycznych

Dział technologii turystycznych Tekravel pisze dla branży: właścicieli agencji, konsolidatorów i deweloperów, którzy ich integrują. Każdy artykuł jest przed publikacją sprawdzany na platformie, którą opisuje.