Pierwsze połączenie z API KOOR.

Zanim wykonasz zapytanie

Firma musi mieć aktywny moduł API i integracje oraz własny klucz. Przechowuj klucz po stronie serwera. Nie umieszczaj go w kodzie strony, adresie URL ani publicznym repozytorium.

Zapytania wysyłaj do adresu aplikacji KOOR, z nagłówkiem:

Authorization: Bearer TWÓJ_KLUCZ_API

Katalog produktów

GET /api/v1/products?limit=100&offset=0

Odpowiedź zawiera pole data z listą produktów. Każdy rekord obejmuje id, name, sku, ean, default_price, vat_rate, unit i is_active.

Parametr limit przyjmuje do 1000 rekordów; domyślnie 1000. offset określa liczbę pominiętych rekordów, domyślnie 0. Pobieraj kolejne strony do otrzymania mniej rekordów niż żądany limit.

Dostępne stany

GET /api/v1/inventory?limit=200&offset=0

Opcjonalnie ogranicz wynik parametrem location_id (UUID punktu) lub sku. Domyślny limit wynosi 200, maksymalny 1000. Pole current_stock oznacza ilość dostępną; rezerwacje nie są częścią dostępnej półki.

Odpowiedzi i ponawianie

• 401: brak poprawnego klucza albo brak dostępu przypisanej firmy.
• 403: moduł integracji jest wyłączony lub nie ma ważnej licencji.
• 429: przekroczony limit. Uwzględnij nagłówek Retry-After.
• 5xx: błąd usługi. Ponów odczyt z narastającym odstępem i ograniczeniem liczby prób.

Kolejny krok: synchronizacja

KOOR udostępnia również zamówienia, zdarzenia i webhooki podpisywane HMAC. Przed wdrożeniem zapisu ustal mapowanie danych, obsługę powtórzeń i konfliktów oraz weryfikację podpisu. Ten przewodnik obejmuje pierwsze zapytania odczytu.