Klucze API

Każde żądanie API wymaga klucza API w nagłówku Authorization. Zapier używa tych samych kluczy. Serwer MCP ich nie potrzebuje; logujesz się do niego w przeglądarce.

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

Wybierz tryb

Klucz należy do trybu, który jest aktywny w chwili jego utworzenia. Włącz tryb testowy, aby dostać klucz pj_test_, albo zostaw go wyłączonym, aby dostać pj_live_.

Otwórz stronę kluczy API

Przejdź do Ustawienia → Klucze API. Link znajdziesz też w menu konta.

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.

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.

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:

Utwórz nowy klucz.
Wdróż go w integracji.
Sprawdź, czy żądania działają.
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.

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

Pierwsze kroki

Sposoby wysyłki

Pocztówki

Konto

Dokumentacja API

Utwórz klucz

Klucze testowe i live

Uprawnienia

Limity

Wymiana i unieważnianie kluczy

Chroń swoje klucze

​Utwórz klucz

​Klucze testowe i live

​Uprawnienia

​Limity

​Wymiana i unieważnianie kluczy

​Chroń swoje klucze

Utwórz klucz

Klucze testowe i live

Uprawnienia

Limity

Wymiana i unieważnianie kluczy

Chroń swoje klucze