Tokeny API | Procurize.AI#

Generuj, zarządzaj i używaj tokenów API dla bezpiecznego programowego dostępu do swojego środowiska Procurize.AI.

Dotyczy: Dashboard Procurize.AI → Ustawienia → Tokeny
Dostępne w: planach Business i Enterprise
Wymagana rola: Security Manager, Editor, Admin lub Maintainer

Przegląd#

Tokeny API umożliwiają bezpieczny, programowy dostęp do platformy Procurize.AI. Możesz używać tokenów do integracji Procurize.AI z własnymi systemami, automatyzacji przepływów pracy lub budowania własnych aplikacji na bazie platformy.

Kluczowe cechy:

Tokeny dziedziczą wszystkie uprawnienia użytkownika, który je utworzył
Tokeny są zakresu organizacji – nie ma potrzeby podawania org w wywołaniach API
Można wygenerować nieograniczoną liczbę tokenów
Tokeny mogą mieć daty wygaśnięcia lub być ustawione jako bezterminowe
Tokeny mogą być dezaktywowane i później reaktywowane w razie potrzeby

🔒 Uwaga dotycząca bezpieczeństwa: Procurize.AI nie przechowuje wartości tokenu – jedynie jego hash. Musisz skopiować i zapisać token od razu po wygenerowaniu. Nie zostanie on wyświetlony ponownie.

Dostęp do panelu zarządzania tokenami#

Przejdź do strony Dashboard → API Tokens.
Panel zarządzania tokenami wyświetla Twoje osobiste tokeny powiązane z bieżącą organizacją.

Strona tokenów API

Wymagane uprawnienie: Tylko użytkownicy z rolami Security Manager, Editor, Admin lub Maintainer mogą uzyskać dostęp do tego panelu. Szczegółowe definicje ról znajdziesz w Permissions Overview .

Generowanie nowego tokenu#

Wprowadź Nazwę, aby zidentyfikować przeznaczenie tokenu.
Wybierz okres ważności:
- 1 miesiąc
- 3 miesiące
- 1 rok
- Brak wygaśnięcia (nieograniczona ważność)
Kliknij „Generate”.

Ważne – Skopiuj token od razu#

Po wygenerowaniu wartość tokenu jest wyświetlana jednorazowo – skopiuj ją i przechowuj bezpiecznie (np. w menedżerze haseł lub zmiennej środowiskowej).

Nowy token API

⚠️ Nie będziesz mógł ponownie zobaczyć wartości tokenu. Procurize.AI przechowuje tylko bezpieczny hash do weryfikacji. Jeśli utracisz token, musisz go unieważnić i wygenerować nowy.

Zarządzanie istniejącymi tokenami#

Panel Tokeny wyświetla listę wszystkich wygenerowanych tokenów wraz z:

Nazwa
Sufiks
Data utworzenia
Data wygaśnięcia (lub „-”)
Status: Aktywny lub Nieaktywny

Dezaktywacja / Reactywacja tokenu#

Deactivate – tymczasowo wyłącza token. Możesz go później reaktywować w razie potrzeby.
Reactivate – przywraca wcześniej dezaktywowany token do stanu aktywnego.

💡 Dezaktywacja jest przydatna do tymczasowego zawieszenia integracji bez usuwania tokenu.

Unieważnianie tokenu#

Revoke – trwale usuwa token. Akcji nie można cofnąć.
Jeśli utracisz token, natychmiast go unieważnij i wygeneruj nowy.

Używanie tokenu API#

Podstawowy URL i uwierzytelnianie#

Parametr	Wartość
Podstawowy URL	`https://api.procurize.com`
Metoda uwierzytelniania	API key via header
Nagłówek	`X-API-Key: <YOUR_API_TOKEN>`

Przykładowe żądanie (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 Nie wymaga ID organizacji – token jest powiązany z Twoją organizacją, więc API automatycznie rozpoznaje kontekst.

Ważne zasady bezpieczeństwa i użytkowania#

Zasada	Wyjaśnienie
Uprawnienia tokenu	Token ma dokładnie takie same uprawnienia jak użytkownik, który go utworzył. Jeśli rola użytkownika się zmieni, uprawnienia tokenu zostaną odpowiednio zaktualizowane.
Powiązanie z organizacją	Tokeny są powiązane z organizacją twórcy. Nie możesz używać tokenu w wielu organizacjach.
Widoczność tokenu	Wartość tokenu jest wyświetlana tylko raz. Przechowaj ją od razu. Procurize.AI przechowuje jedynie hash.
Wygasłe tokeny	Wygasłe tokeny są automatycznie dezaktywowane i nie mogą być używane. W razie potrzeby wygeneruj nowy token.

Rozwiązywanie problemów#

Problem	Rozwiązanie
Błąd „Invalid API key”	Sprawdź, czy token został poprawnie skopiowany (bez dodatkowych spacji). Zweryfikuj, czy token jest nadal aktywny i nie wygasł.
Token nie działa po zmianie roli	Uprawnienia tokenu są aktualizowane, aby odpowiadały bieżącej roli użytkownika. Jeśli użytkownik stracił uprawnienia, token również je traci.
Utracony token	Unieważnij utracony token i wygeneruj nowy.
Ograniczenia szybkości	Limity szybkości API obowiązują w zależności od Twojego planu. Sprawdź nagłówki `X-RateLimit-*` w odpowiedzi.

Powiązane tematy#

Permissions Overview – szczegółowe definicje ról
Pricing Plans – które plany zawierają dostęp do API
REST API Reference – szczegółowa dokumentacja endpointów