Zanim zatrudnisz firmę od integracji API w Dubaju

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.
- 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ść.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
| Droga | Kto ma relację z dostawcą | Kto dba o działanie połączenia | Co biuro musi jeszcze zbudować | Ile kosztuje odejście |
|---|---|---|---|---|
| Integrator łączy Twoją stronę z API dostawcy | Biuro, jeśli brief tak mówi; inaczej często integrator | Integrator w ramach umowy serwisowej albo nikt | Panel, marże, kartoteka klientów, raporty, płatności, ekrany obsługi posprzedażowej | Niewiele, jeśli kod i klucze są Twoje; przebudowa, jeśli nie są |
| Integrator łączy Twoją stronę z API platformy | Platforma ma umowy z dostawcami; biuro ma konto na platformie | Platforma po stronie dostawcy; integrator po Twojej stronie | Twoją stronę i to, czego API platformy nie obejmuje | Przepisanie Twojej strony pod inne API |
| Sklep white-label, który jest już podłączony | Platforma, przez konto biura | Platforma | Treści, decyzje cenowe, własnych klientów | Przeniesienie 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.