> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paperjoy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Klucze API

> Twórz, używaj, chroń i wymieniaj klucze, które uwierzytelniają API Paperjoy i Zapier.

Każde żądanie API wymaga klucza API w nagłówku `Authorization`. Zapier używa tych samych kluczy. [Serwer MCP](https://docs.paperjoy.co/integrations/mcp.md) ich nie potrzebuje; logujesz się do niego w przeglądarce.

```bash theme={null}
curl https://paperjoy.co/api/user \
  --header "Authorization: Bearer $PAPERJOY_API_KEY" \
  --header "Accept: application/json"
```

Działający klucz zwraca dane konta i `available_credit_balance`.

## Utwórz klucz

**1. Wybierz tryb**

Klucz należy do trybu, który jest aktywny w chwili jego utworzenia. Włącz [tryb testowy](https://docs.paperjoy.co/getting-started/test-mode.md), aby dostać klucz `pj_test_`, albo zostaw go wyłączonym, aby dostać `pj_live_`.

**2. Otwórz stronę kluczy API**

Przejdź do [**Ustawienia → Klucze API**](https://paperjoy.co/settings/api-tokens). Link znajdziesz też w menu konta.

**3. Nazwij i utwórz klucz**

Wybierz nazwę, która mówi, gdzie klucz jest używany, np. `sklep-backend` lub `zapier-crm`, i kliknij **Utwórz klucz**.

**4. Skopiuj go od razu**

Pełny klucz jest widoczny tylko raz. Wklej go do menedżera sekretów lub zmiennych środowiskowych, zanim opuścisz stronę.

![Strona Klucze API zaraz po utworzeniu klucza, z jednorazowo widocznym kluczem i listą wydanych kluczy.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/app/api-token-created.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=a997ac0e3d3f99ffd7eb6d407a6d48b2)

## Klucze testowe i live

| Prefiks | Tryb | Co robi `POST /api/postcards` |
| - | - | - |
| `pj_test_` | Testowy | Tworzy darmową pocztówkę testową, która nigdy nie jest wysyłana. |
| `pj_live_` | Live | Składa prawdziwe zamówienie i zużywa jeden kredyt. |

Prefiks pomaga Tobie i skanerom sekretów rozpoznać klucz. Sam tryb jest zapisany razem z kluczem i nie może się zmienić.

## Uprawnienia

Klucze utworzone w panelu mają wszystkie poniższe uprawnienia.

| Uprawnienie | Pozwala na |
| - | - |
| `user:read` | `GET /api/user` |
| `postcards:read` | `GET /api/postcards`, `GET /api/postcards/{id}` |
| `postcards:write` | `POST /api/postcards`, `POST /api/postcards/preview` |
| `signatures:read` | `GET /api/signatures`, `GET /api/signatures/{id}` |
| `signatures:write` | `DELETE /api/signatures/{id}` |

## Limity

| Limit | Wartość |
| - | - |
| Kluczy na użytkownika | 20, łącznie w obu trybach |
| Ważność | 1 rok od utworzenia |
| Nazwa | 3–80 znaków: litery, cyfry, spacje, `.`, `_` lub `-` |

## Wymiana i unieważnianie kluczy

Aby unieważnić klucz, otwórz menu **Więcej** obok niego i wybierz **Unieważnij klucz**. Klucz przestaje działać natychmiast. Strona pokazuje tylko klucze z bieżącego trybu, więc aby zarządzać pozostałymi, przełącz tryb.

Wymiana klucza bez przerwy w działaniu:

1. Utwórz nowy klucz.
2. Wdróż go w integracji.
3. Sprawdź, czy żądania działają.
4. Unieważnij stary klucz.

Zaplanuj wymianę przed upływem roku. Data wygaśnięcia jest widoczna przy każdym kluczu.

## Chroń swoje klucze

* Trzymaj klucze na serwerze, w menedżerze sekretów lub zmiennych środowiskowych.
* Nigdy nie umieszczaj klucza w JavaScripcie przeglądarki, aplikacji mobilnej ani publicznym repozytorium.
* Używaj osobnego klucza dla każdej integracji, aby móc unieważnić jeden bez psucia pozostałych.
* Natychmiast unieważnij klucz, który mógł wyciec.

> [!WARNING]
>
> Każdy, kto ma klucz `pj_live_`, może składać prawdziwe zamówienia na Twoim koncie. Traktuj go jak hasło.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.