Demo na żywo

Przewodnik

Czym jest integracja API, wyjaśnione dla firm turystycznych

Integracja API to połączenie, które pozwala dwóm systemom wymieniać dane i uruchamiać działania bez ręcznego przepisywania czegokolwiek. Ten przewodnik wyjaśnia, jak to działa, na przykładzie jednej rezerwacji hotelu, która przechodzi między podróżnym, platformą rezerwacyjną, API dostawcy i bramką płatności.

  • Jedno żądanie, jedna odpowiedź
  • REST, XML, SOAP i webhooki
  • Jedna rezerwacja prześledzona w czterech systemach
  • Jak testuje się integracje

Definicja

Czym jest integracja API, prostym językiem

API to skrót od application programming interface: zbiór reguł, które system publikuje, aby inne oprogramowanie mogło się z nim komunikować. Integracja API to praca polegająca na podłączeniu Twojej platformy do jednego z takich interfejsów, tak aby dane przepływały, a działania wykonywały się automatycznie.

W turystyce tą platformą jest zwykle system rezerwacyjny taki jak Oprogramowanie rezerwacji podróży, a interfejs należy do dostawcy, bramki płatności lub narzędzia biznesowego. Nasza strona Integracja API turystycznych wyjaśnia, jak PHPTRAVELS realizuje takie połączenia, a Wszystkie integracje wymienia dostawców, którzy są już podłączeni.

  • Wymiana danych

    Stawki, dostępność, dane klientów i aktualizacje statusu przemieszczają się między systemami w ustrukturyzowanym formacie.

  • Automatyzacja działań

    Wyszukiwanie, rezerwacja, płatność, anulowanie i uzgadnianie odbywają się jako żądania, a nie kroki, które ktoś powtarza ręcznie.

  • Śledzenie wyników

    Każde wywołanie niesie referencję, dzięki czemu nieudaną rezerwację można prześledzić do żądania, które ją spowodowało.

Żądanie

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

Odpowiedź

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
Przykładowe wywołanie do fikcyjnego dostawcy hoteli. Nazwy pól, endpointy i kwoty różnią się w zależności od dostawcy.

Anatomia jednego wywołania API

  1. 1

    Endpoint i metoda

    Adres operacji i czasownik użyty wobec niej: POST do availability oznacza wyszukiwanie pokoi.

  2. 2

    Uwierzytelnianie

    Klucz, token lub podpis dowodzi, kto wywołuje. Dostawcy wydają osobne dane dostępowe dla sandboxa i produkcji.

  3. 3

    Payload

    Ustrukturyzowane dane wejściowe: miasto, daty, goście i waluta. Dokumentacja dostawcy definiuje każde pole.

  4. 4

    Kod statusu

    Liczba, która mówi, jak przebiegło wywołanie: 200 to sukces, 4xx problem z żądaniem, 5xx problem po stronie dostawcy.

  5. 5

    ID żądania

    Identyfikator, który przechowują obie strony. Gdy wsparcie pyta, co stało się z rezerwacją, właśnie tego szuka.

  6. 6

    Treść odpowiedzi

    Odpowiedź w formacie dostawcy, którą Twoja platforma mapuje na własne pokoje, stawki i zasady.

Jedna rezerwacja, cztery systemy

Co robi integracja API podczas rezerwacji hotelu

Prześledź jeden dwunocny pobyt od wyszukiwania do vouchera. Każda strzałka to wywołanie API; podróżny widzi tylko pierwsze i ostatnie.

  1. 01PodróżnyPlatforma rezerwacyjnaSzuka hoteli w Dubaju, dwie noce, dwóch gości
  2. 02Platforma rezerwacyjnaAPI dostawcyŻądanie dostępności z datami, gośćmi i walutą
  3. 03API dostawcyPlatforma rezerwacyjnaPokoje, stawki, zasady i klucz stawki
  4. 04Platforma rezerwacyjnaPodróżnyWyniki pokazane z Twoją marżą i walutą
  5. 05Platforma rezerwacyjnaAPI dostawcyPonowne sprawdzenie ceny dla wybranego klucza stawki przed płatnością
  6. 06Platforma rezerwacyjnaBramka płatnościAutoryzacja płatności na łączną kwotę
  7. 07Bramka płatnościPlatforma rezerwacyjnaAutoryzowano, odebrano podpisany webhook
  8. 08Platforma rezerwacyjnaAPI dostawcyŻądanie rezerwacji z danymi gościa
  9. 09API dostawcyPlatforma rezerwacyjnaNumer potwierdzenia i warunki anulowania
  10. 10Platforma rezerwacyjnaPodróżnyVoucher, faktura i numer referencyjny rezerwacji

Platforma pośrodku to miejsce, w którym żyje integracja API: tłumaczy między ekranem podróżnego a formatem każdego dostawcy i przechowuje każdą referencję.

Ta sama sekwencja obsługuje Oprogramowanie do rezerwacji lotów z GDS, Oprogramowanie dla touroperatorów z dostawcą atrakcji i Integracja bramek płatniczych z dowolną bramką; zmieniają się tylko nazwy pól.

Style integracji

REST, XML, SOAP, webhooki i GraphQL

Dostawcy publikują swoje interfejsy w różnych stylach. O stylu decyduje dokumentacja dostawcy, a nie preferencje, dlatego platforma turystyczna musi obsługiwać je wszystkie.

  • REST i JSON

    JSON
    Format danych
    Dokumenty JSON
    Transport
    Metody HTTP: GET, POST, PUT, DELETE
    Typowe w turystyce
    Nowsze API lotów, hoteli, atrakcji i płatności
    Mocna strona
    Zwięzłe payloady i szeroki zestaw narzędzi deweloperskich
    Na co uważać
    Luźna specyfikacja; każdy dostawca interpretuje REST inaczej

  • XML i SOAP

    XML
    Format danych
    Dokumenty XML, często ze ścisłym schematem
    Transport
    HTTP POST z kopertą SOAP lub czystym XML
    Typowe w turystyce
    GDS, bedbanki oraz ugruntowane systemy hotelowe i wycieczkowe
    Mocna strona
    Formalne kontrakty, podpisy i definicje usług
    Na co uważać
    Rozwlekłe komunikaty i cięższe parsowanie

  • Webhooki

    EVENT
    Format danych
    JSON lub XML, wysyłane przez drugą stronę
    Transport
    HTTP POST na zarejestrowany przez Ciebie URL
    Typowe w turystyce
    Wyniki płatności, zmiany statusu rezerwacji, aktualizacje biletowania
    Mocna strona
    Bez odpytywania; platforma dowiaduje się, gdy coś się wydarzy
    Na co uważać
    Podpisy trzeba weryfikować, a powtórzenia obsługiwać

  • GraphQL

    QUERY
    Format danych
    JSON, ukształtowany przez wysłane zapytanie
    Transport
    Jeden endpoint HTTP
    Typowe w turystyce
    Niektóre nowsze platformy dystrybucyjne i wewnętrzne API
    Mocna strona
    Prosisz dokładnie o te pola, których potrzebujesz
    Na co uważać
    Wsparcie dostawców w turystyce jest wciąż rzadkie

Integracja API a tworzenie API

Integracja API

Łączy Twój produkt z interfejsem, który już istnieje. Dostawca jest właścicielem API; Ty budujesz klienta, mapowanie i reguły wokół niego.

Tworzenie API

Tworzy interfejs, którego inne systemy używają do łączenia się z Twoim produktem, na przykład API B2B, które mogą wywoływać narzędzia Twoich agentów. Ty jesteś właścicielem kontraktu i jego wersji.

Wiele projektów turystycznych potrzebuje obu: platforma integruje dostawców z jednej strony, a z drugiej publikuje własne API dla agentów i partnerów.

Przed i po

Co się zmienia, gdy systemy są zintegrowane

Te same pięć kroków rezerwacji, wykonanych ręcznie w portalach dostawców i wykonanych przez integrację API.

Wyszukiwanie

Bez integracjiRęcznie

Agent otwiera każdy portal dostawcy i kopiuje ceny do oferty.

Z integracją APIAutomatycznie

Jedno wyszukiwanie trafia do każdego podłączonego dostawcy i zwraca jedną listę.

Cena

Bez integracjiRęcznie

Marża jest dodawana w arkuszu; zanim oferta zostanie wysłana, stawka mogła się zmienić.

Z integracją APIAutomatycznie

Marża, podatki i reguły walutowe są stosowane w chwili odpowiedzi; stawka jest ponownie sprawdzana przed płatnością.

Rezerwacja

Bez integracjiRęcznie

Dane gościa są przepisywane do portalu dostawcy; literówki stają się błędami rezerwacji.

Z integracją APIAutomatycznie

Dane są wysyłane raz, walidowane i zapisywane wraz z potwierdzeniem dostawcy.

Płatność

Bez integracjiRęcznie

Płatność jest pobierana osobno i dopasowywana do rezerwacji później.

Z integracją APIAutomatycznie

Autoryzacja, pobranie i zwrot są powiązane z numerem referencyjnym rezerwacji.

Obsługa

Bez integracjiRęcznie

Anulowania i zmiany oznaczają kolejne logowanie i kolejny e-mail.

Z integracją APIAutomatycznie

Zmiany i anulowania przechodzą przez to samo połączenie i aktualizują rekord.

Gdzie integracja API pojawia się w platformie turystycznej

Słownictwo

Terminy, które spotkasz w dokumentacji API

Dwanaście słów, które pojawiają się w portalu deweloperskim niemal każdego dostawcy, zdefiniowanych tak, jak używa się ich w turystyce.

  • API

    Application programming interface: opublikowane reguły komunikacji z systemem.

  • Uwierzytelnianie

    Udowodnienie, kto wywołuje, za pomocą klucza API, tokena bearer, podpisu lub zatwierdzonego adresu IP.

  • Certyfikacja

    Przegląd Twojej integracji przez dostawcę przed wydaniem produkcyjnych danych dostępowych.

  • Endpoint

    Jeden adres dla jednej operacji, takiej jak wyszukiwanie, rezerwacja lub anulowanie.

  • Idempotentność

    Wysłanie tego samego żądania dwa razy daje jeden wynik, co zapobiega podwójnym rezerwacjom i obciążeniom.

  • Mapowanie

    Tłumaczenie pól, kodów i nazw dostawcy na własny model danych Twojej platformy.

  • Payload

    Dane przenoszone wewnątrz żądania lub odpowiedzi, zwykle JSON lub XML.

  • Limit wywołań

    Liczba wywołań, na które dostawca pozwala na sekundę lub na dzień, zanim zacznie je odrzucać.

  • Żądanie i odpowiedź

    Jedno wywołanie: Twoja platforma pyta, dostawca odpowiada, a obie strony to logują.

  • Sandbox

    Środowisko testowe z fikcyjnym inwentarzem i kartami testowymi, w którym nic nie jest naprawdę rezerwowane ani obciążane.

  • Kod statusu

    Liczba HTTP podsumowująca wynik: 200 sukces, 401 brak autoryzacji, 429 przekroczony limit, 500 błąd dostawcy.

  • Webhook

    Wywołanie w drugą stronę: dostawca lub bramka powiadamia Twoją platformę, gdy zajdzie zdarzenie.

Testowanie i zakres

Jak testuje się turystyczną integrację API przed uruchomieniem

Integracja jest gotowa dopiero wtedy, gdy ścieżki błędów zachowują się poprawnie. Przebieg testowy w sandboxie dostawcy obejmuje poniższe przypadki przed certyfikacją i przejściem na produkcyjne dane dostępowe.

uruchom testy integracji

sandbox dostawcy, dziewięć przypadków

  • OK: Uwierzytelnianie z ważnymi i wygasłymi danymi dostępowymi
  • OK: Nieprawidłowe żądanie odrzucone z czytelnym błędem
  • OK: Przekroczenie czasu po stronie dostawcy obsłużone bez zawieszonej rezerwacji
  • OK: Limit wywołań przestrzegany i ponowiony po odczekaniu
  • OK: Zmiana ceny wychwycona przy ponownym sprawdzeniu i pokazana przed płatnością
  • OK: Podwójne wysłanie zwraca pierwszą rezerwację, a nie drugą
  • OK: Anulowanie zastosowane i opłaty obliczone
  • OK: Zwrot wykonany na pierwotną płatność
  • OK: Referencje rezerwacji, płatności i dostawcy są zgodne

Wszystkie przypadki zaliczone, gotowe do certyfikacji

Czego wymaga od Ciebie określenie zakresu

  1. 1Umowa z dostawcą, dokumentacja i dane dostępowe do sandboxa
  2. 2Rynki, waluty, produkty i role użytkowników
  3. 3Zakres wyszukiwania, rezerwacji, zmian, anulowań i zwrotów
  4. 4Wymagania certyfikacyjne i proces uzyskania dostępu produkcyjnego

Gotowi podłączyć dostawcę

PHPTRAVELS integruje dostawców, bramki i narzędzia biznesowe w samodzielnie hostowanej platformie dostarczanej z kodem źródłowym. Zobacz Cennik, aby poznać trzy plany z jednorazową opłatą, lub zapytaj nas o konkretne API.

Poproś o demoPorozmawiaj z nami

Czytaj dalej

Pytania

Pytania o integrację API, z odpowiedziami

Krótkie odpowiedzi na pytania, które ludzie zadają przed pierwszym projektem integracyjnym.

Kontakt ze sprzedażą

Integracja API to połączenie, które pozwala dwóm systemom automatycznie wymieniać dane i uruchamiać działania. Jeden system wysyła ustrukturyzowane żądanie, drugi zwraca ustrukturyzowaną odpowiedź, a oba przestrzegają uzgodnionych reguł bezpieczeństwa i danych.

W turystyce łączy platformę rezerwacyjną z dostawcami lotów, hoteli, wycieczek lub samochodów, bramkami płatności i narzędziami biznesowymi. Obsługuje wyszukiwanie, walidację cen, rezerwację, anulowanie, zwroty i uzgadnianie bez ręcznego przepisywania.

REST to styl architektoniczny, który zwykle wymienia JSON przez HTTP. XML to format danych wciąż powszechny u dostawców GDS i bedbanków, często opakowany w SOAP. O tym, którego użyjesz, decyduje kontrakt i dokumentacja dostawcy.

Zależy to od dostępu do dostawcy, endpointów w zakresie, certyfikacji, reguł mapowania i przypadków brzegowych rezerwacji. Wiarygodna wycena powstaje po przeglądzie dokumentacji, danych dostępowych i potrzebnych przepływów pracy.

Testuj uwierzytelnianie, prawidłowe i nieprawidłowe żądania, przekroczenia czasu, limity wywołań, zmiany cen, podwójne wysłania, anulowania, zwroty i uzgadnianie. Na produkcji każde żądanie powinno dać się prześledzić do numeru referencyjnego rezerwacji.

Nie. Integracja łączy Twój produkt z istniejącym API; tworzenie buduje interfejs, z którym łączą się inni. Platformy turystyczne często potrzebują obu: dostawców zintegrowanych z jednej strony i API B2B opublikowanego dla partnerów z drugiej.

Odkryj więcej

Więcej o platformie