Tokeny API | Procurize.AI#

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

Obejmuje: Procurize.AI Dashboard → Ustawienia → Tokeny
Dostępne w: planach Business i Enterprise
Wymagana rola: Administrator 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ą powiązane z organizacją – nie trzeba podawać org w wywołaniach API
Można wygenerować nieograniczoną liczbę tokenów
Tokeny mogą mieć daty wygaśnięcia lub być ustawione jako nieograniczone
Tokeny mogą być dezaktywowane i później reaktywowane w razie potrzeby

🔒 Uwaga dotycząca bezpieczeństwa: Procurize.AI nie przechowuje wartości tokenu – tylko jego skrót (hash). Należy skopiować i zapisać token natychmiast po wygenerowaniu. Nie będzie on wyświetlony ponownie.

Dostęp do Panelu Zarządzania Tokenami#

Przejdź do Dashboard → Ustawienia → zakładka Tokeny.
Panel zarządzania tokenami wyświetla Twoje osobiste tokeny powiązane z bieżącą organizacją.

Panel tokenów API

Wymagane uprawnienie: Tylko użytkownicy z rolą Administrator lub Maintainer mogą uzyskać dostęp do tego panelu. Szczegółowe definicje ról znajdziesz w Przegląd uprawnień .

Generowanie Nowego Tokenu#

Wpisz 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 „Generuj”.

Ważne – Skopiuj Token Natychmiast#

Po wygenerowaniu wartość tokenu jest wyświetlana raz – skopiuj ją i przechowaj w bezpiecznym miejscu (np. w menedżerze haseł lub zmiennej środowiskowej).

Nowy token API

⚠️ Nie będziesz mógł ponownie zobaczyć wartości tokenu. Procurize.AI przechowuje wyłącznie bezpieczny skrót do weryfikacji. Jeśli utracisz token, musisz go odwołać i wygenerować nowy.

Zarządzanie Istniejącymi Tokenami#

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

Nazwą
Sufiksem
Datą utworzenia
Datą wygaśnięcia (lub „-”)
Stanem: Aktywny lub Nieaktywny

Dezaktywacja / Reactywacja Tokenu#

Dezaktywuj – tymczasowo wyłącza token. Możesz go ponownie aktywować później, gdy będzie potrzebny.
Reaktywuj – przywraca wcześniej dezaktywowany token do stanu aktywnego.

💡 Dezaktywacja jest przydatna, gdy chcesz tymczasowo wstrzymać integracje bez usuwania tokenu.

Odwołanie Tokenu#

Odwołaj – trwale usuwa token. Akcji tej nie można cofnąć.
Jeśli utracisz token, odwołaj go natychmiast i wygeneruj nowy.

Używanie Tokenu API#

Podstawowy URL i uwierzytelnianie#

Parametr	Wartość
Podstawowy URL	`https://api.procurize.com`
Metoda uwierzytelniania	Klucz API w nagłówku
Nagłówek	`X-API-Key: <TWÓJ_TOKEN_API>`

Przykładowe żądanie (cURL)#

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

🧠 Nie potrzebujesz identyfikatora 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 te same uprawnienia, co użytkownik, który go utworzył. Jeśli rola użytkownika się zmieni, uprawnienia tokenu zostaną zaktualizowane.
Powiązanie z organizacją	Tokeny są przypisane do organizacji twórcy. Nie możesz używać tokenu w wielu organizacjach jednocześnie.
Widoczność tokenu	Wartość tokenu jest wyświetlana tylko raz. Zapisz ją od razu. Procurize.AI przechowuje jedynie skrót.
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ł skopiowany poprawnie (bez dodatkowych spacji). Zweryfikuj, czy token jest nadal aktywny i nie wygasł.
Token nie działa po zmianie roli	Uprawnienia tokenu są aktualizowane zgodnie z obecną rolą użytkownika. Jeśli użytkownik utracił uprawnienia, token również je straci.
Utracony token	Odwołaj utracony token i wygeneruj nowy.
Ograniczenie liczby zapytań	Limity zapytań API zależą od Twojego planu. Sprawdź nagłówki `X-RateLimit-*` w odpowiedzi.

Powiązane Tematy#

Przegląd uprawnień – szczegółowe definicje ról
Plany cenowe – które plany obejmują dostęp do API
Referencja REST API – szczegóły endpointów