Dokumentacja
Aktualna dokumentacja API xSale dostępna jest w formacie Swagger: https://api.xsale.ai/swagger
Technologia
API xSale jest udostępnione w technologii REST.
Rozwój i zmiany w działaniu endpointów
Wszystkie zmiany mające wpływ na zerwanie kompatybilności wstecznej (tzw. breaking changes) będą odpowiednio wcześnie zgłaszane użytkownikom.
Mniejsze zmiany zachowujące kompatybilność wsteczną będą nanoszone na bieżąco bez informowania użytkowników.
Co nie łamie kompatybilności wstecznej?
- Dodatkowe pola w zwracanych odpowiedziach z endpointów GET
- Dodatkowe nie wymagane pola w endpointach POST/PUT
- Dodatkowe filtry w endpointach GET
- Dodatkowe sortowania w endpointach GET
- Drobne poprawki w Swagger
- Dodanie nowego endpointa
Co łamie kompatybilność wsteczna?
- Usunięcie lub zmiana nazwy pola w endpointach GET/POST/PUT
- Usunięcie lub zmiana nazwy filtra
- Usunięcie lub zmiana nazwy sortowania
- Zmiana struktury odpowiedzi lub danyh przyjmowanych przez endpoint
- Zmiana kodu odpowiedzi
- Zmiana ścieżki lub usunięcie endpointa
- Zmiana metody http w endpoincie
Uwierzytelnienie
Logowanie do API odbywa się danymi dostępowymi do xSale. Jeśli przygotowujesz aplikację, wyślij zgłoszenie na helpdesk z opisem aplikacji a zostaną dla Ciebie wygenerowane dane do logowania przez aplikacje.
Zastosowanie
API xSale umożliwia programistom integracje m.in. z własnym, dedykowanym systemem ERP lub dostęp do wspieranych ERP przez REST API xSale i inne dedykowane zastosowania.
API xSale można wykorzystać również jako REST API do Comarch ERP Optima lub REST API do Comarch ERP XL dzięki temu możliwie jest np. pobieranie przez API informacji z Comarch Optima oraz pobieranie przez API z Comarch XL (np. o kontrahentach, towarach), a także dodawanie danych np. dodawanie płatności przez API do Comarch Optima lub dodawanie kontrahentów przez API do Comarch XL
