Klucz API przekazuje się w nagłówku X-inFakt-ApiKey. Daje on dostęp do danych jednego konta inFakt, w zakresie uprawnień wybranych przy jego tworzeniu.
Klucz generuje się w aplikacji WWW, w Ustawienia → Inne opcje → API: należy podać opis klucza, hasło do konta i zakresy uprawnień, a następnie kliknąć Wygeneruj. W tym samym miejscu usuwa się klucze, które nie są już potrzebne.
Zakresy uprawnień
Klucz z pełnymi uprawnieniami ma dostęp m.in. do rachunków bankowych i rozliczeń podatkowych, a integracja sklepu internetowego zwykle potrzebuje tylko faktur. Klucz z wąskim zakresem po wycieku ujawnia mniej danych. Najlepiej generować osobny klucz dla każdej integracji: usunięcie jednego z nich nie zatrzymuje pozostałych.
Ograniczenia
- Klucz działa tylko w środowisku, w którym go wygenerowano. Klucz z sandboxa nie działa na produkcji.
- Klucz daje dostęp do jednego konta. Integracja obsługująca wielu klientów inFakt potrzebuje klucza od każdego z nich.
- Klucz API nie służy do logowania w serwerze MCP inFakt. Ten serwer używa logowania OAuth w przeglądarce.