REST API
REST API to najpopularniejszy styl budowy interfejsów sieciowych, w którym operacje wykonuje się przez standardowe metody protokołu HTTP na adresach reprezentujących zasoby. Dane przekazywane są zwykle w formacie JSON, co ułatwia integrację niezależnie od technologii systemów.
Cechy REST
- Operacje na zasobach przez metody HTTP.
- Bezstanowość — każde wywołanie zawiera komplet potrzebnych danych.
- Format JSON, czytelny i lekki.
- Uwierzytelnianie tokenem lub kluczem.
Na co uważać w praktyce
Na limity liczby wywołań, obsługę stronicowania przy dużych zbiorach oraz na to, co dzieje się przy przerwaniu połączenia w trakcie operacji. Te trzy elementy decydują o stabilności integracji na produkcji.
Rozwiązania oparte na integracjach opisuje strona Enterprise Solutions.
Przykłady zastosowania
System pobiera listę kontrahentów zmienionych od ostatniej synchronizacji, a nie całą bazę.
Przy błędzie połączenia wywołanie jest ponawiane trzy razy, a potem trafia do kolejki.
Najczęstsze pytania
Czym REST różni się od SOAP?
REST jest lżejszy i oparty na JSON, SOAP bardziej rozbudowany i oparty na XML. Starsze systemy częściej udostępniają SOAP.
Czy REST API wymaga programisty?
Do konfiguracji gotowych konektorów zwykle nie. Przy nietypowych scenariuszach potrzebne jest wsparcie techniczne.
Powiązane hasła
Zobacz, jak wygląda to w systemach, które wdrażamy w polskich firmach.
