# 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

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

![Panel tokenów API](/images/docs/api-tokens-panel.png)

> **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ń](/what-user-permissions-does-procurize-have/) .

## Generowanie Nowego Tokenu

1. Wpisz **Nazwę**, aby zidentyfikować przeznaczenie tokenu.  
2. Wybierz **okres ważności**:
   - 1 miesiąc
   - 3 miesiące
   - 1 rok
   - **Brak wygaśnięcia** (nieograniczona ważność)

3. 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](/images/docs/new-api-token.png)

> ⚠️ **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)

```bash
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ń](/what-user-permissions-does-procurize-have/) – szczegółowe definicje ról  
- [Plany cenowe](https://www.procurize.ai/pricing/) – które plany obejmują dostęp do API  
- [Referencja REST API](/rest-api-reference/) – szczegóły endpointów  

{{<article-feedback>}}