Co to jest API REST i jak działa w integracjach?
API REST to sposób komunikacji programów przez internet, oparty na adresach i standardowych operacjach: pobierz, dodaj, zmień, usuń. Sklep, Allegro czy operator płatności udostępniają API, przez które inny system może na przykład pobrać listę zamówień albo zmienić stan produktu. Dane są przesyłane zwykle w formacie JSON.
Co to jest webhook i jak wykorzystuje się go w integracjach?
Webhook to powiadomienie wysyłane przez system na wskazany adres w chwili zdarzenia, na przykład po złożeniu zamówienia lub zaksięgowaniu płatności. Dzięki temu integracja nie musi co chwilę pytać o nowości - dowiaduje się o nich od razu.
API czy webhook - kiedy co?
Webhooki sprawdzają się, gdy liczy się szybka reakcja na zdarzenie. Cykliczne odpytywanie API jest prostsze i bezpieczniejsze tam, gdzie system nie wysyła powiadomień albo gdy trzeba regularnie uzgadniać całość danych, na przykład stany. W praktyce łączy się obie metody: webhook uruchamia działanie, a okresowe sprawdzenie przez API wyłapuje to, co mogło nie dotrzeć.
Webhooki nie wyzwalają automatyzacji - co sprawdzić?
- czy adres odbierający jest dostępny z internetu i działa po HTTPS
- czy odpowiada kodem powodzenia w wymaganym czasie
- czy zgadza się sekret lub podpis, którym nadawca zabezpiecza powiadomienia
- czy nadawca nie wyłączył webhooka po serii nieudanych prób
- czy webhook jest ustawiony na właściwy rodzaj zdarzenia
- co pokazuje historia dostarczeń po stronie nadawcy
Najczęstsze pytania
Jak działa REST API Allegro?
Allegro udostępnia API REST, przez które po autoryzacji konta można między innymi pobierać zamówienia, zmieniać stany i ceny ofert oraz dodawać numery przesyłek i faktury do zamówień. Zobacz szczegóły
Czy KCD Studio tworzy dedykowane API dla firm?
Tak. KCD Studio projektuje i buduje API w standardach REST i GraphQL oraz webhooki, przez które systemy firmy wymieniają dane.