Przejdź do treści

Łączenie z REST API

Gdzie znaleźć dokumentację API, jak się uwierzytelniać oraz jakie limity i zasady obowiązują każde żądanie.

Czas czytania: 4 min Prawdziwe ekrany, fikcyjne dane przykładowe Zaktualizowano 22 października 2026

REST API zapewnia programowy dostęp do danych firmy. Jest przeznaczone dla programistów tworzących integracje; nie jest potrzebne do codziennej pracy.

  • Dokumentacja API: pełna dokumentacja jest publicznie dostępna pod /docs/api na adresie Twojego obszaru roboczego, a dokument OpenAPI pod /docs/api/openapi.yaml i /docs/api/openapi.json. Link do niej znajduje się w API i webhooki w Ustawieniach.
  • Bazowy URL: wyświetlany na górze strony API i webhooki. Kończy się na /api/v1.
  • Uwierzytelnianie: wyślij nagłówek Authorization: Bearer, a po nim swój token, oraz Accept: application/json.
  • Odpowiedzi: wyłącznie JSON. Pojedyncze rekordy są opakowane w data; listy dodają meta i links do paginacji kursorowej (parametry limit i cursor, do 100 na stronę).
  • Bezpieczne ponawianie: wysyłaj nagłówek Idempotency-Key w żądaniach POST. Powtórzenie tego samego żądania z tym samym kluczem zwraca zapisaną odpowiedź zamiast tworzyć drugi rekord. Klucze są przechowywane przez 24 godziny.
  • Limit żądań: 120 żądań na minutę na token. Nagłówki X-RateLimit-Limit i X-RateLimit-Remaining pokazują bieżący stan; po przekroczeniu limitu otrzymasz 429 z nagłówkiem Retry-After.

Co może zrobić żądanie

Wywołanie kończy się powodzeniem tylko wtedy, gdy token ma odpowiednie uprawnienie (np. invoices:write), a użytkownik tokena ma odpowiadające mu uprawnienie w aplikacji. Obowiązują te same reguły biznesowe co na ekranie, więc wystawionej faktury nie można edytować także przez API.

Zapytaj o produkt

Zapytaj, co potrafi oprogramowanie, jak działa dane zadanie lub jakie kraje i języki obsługuje. Odpowiedzi pochodzą z tych poradników.

Myślę…

Asystent AI jest w tej chwili niedostępny. Przeszukaj przewodniki lub porozmawiaj z naszym zespołem. Kontakt z pomocą techniczną

AI może popełniać błędy. Sprawdź podlinkowane poradniki.

Nadal potrzebujesz pomocy?

Nasz zespół wsparcia czyta każdą wiadomość i odpowiada prostym językiem.

Kontakt z pomocą techniczną
Czat z AI