> ## 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.

# Tryb testowy

> Zbuduj i sprawdź integrację bez zużywania kredytów i wysyłania prawdziwych pocztówek.

Tryb testowy to osobna piaskownica w Twoim koncie. Pocztówki testowe przechodzą tę samą walidację i weryfikację treści co pocztówki live, ale są darmowe i Paperjoy nigdy ich nie pisze ani nie wysyła.

![Panel Paperjoy w trybie testowym z banerem Tryb testowy u góry.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/app/test-mode.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=5669fa402a08656361a09a85d93e50ab)

Gdy tryb testowy jest włączony, u góry każdej strony widać baner.

## Włączanie i wyłączanie

Otwórz menu konta w prawym górnym rogu panelu Paperjoy i przełącz **Tryb testowy**. Aby wyjść, użyj tego samego przełącznika albo kliknij **Wyłącz tryb testowy** na banerze.

Przełącznik zmienia to, co widzisz w panelu, i rodzaj klucza API, który utworzysz. Nie zmienia istniejących kluczy.

## Testowanie każdego sposobu wysyłki

> [tab] Edytor
>
> Włącz tryb testowy i otwórz **Edytor**. Przycisk wysyłki zmieni się na **Utwórz testową pocztówkę**.

> [tab] API
>
> Utwórz klucz API przy włączonym trybie testowym. Zaczyna się od `pj_test_`. Każde żądanie wykonane tym kluczem działa w trybie testowym, a odpowiedzi zawierają `"test_mode": true`.
>
> Adresy URL i body żądań są identyczne w obu trybach. Nigdy nie wysyłaj pola `test_mode`; o trybie decyduje klucz.

> [tab] Zapier
>
> Utwórz klucz `pj_test_` i dodaj go w Zapierze jako osobne połączenie z Paperjoy. Używaj go podczas budowania i testowania Zapa, a przed włączeniem Zapa przełącz akcję na połączenie z kluczem `pj_live_`.

> [tab] MCP
>
> Serwer MCP nie ma trybu testowego. Zawsze tworzy pocztówki live i zużywa kredyty, nawet jeśli w przeglądarce masz włączony tryb testowy.
>
> Najpierw sprawdź wiadomość w edytorze albo kluczem `pj_test_` w API i poproś asystenta, by przed wysłaniem każdej kartki prosił Cię o potwierdzenie.

## Co robi pocztówka testowa

| | Testowa | Live |
| - | - | - |
| Zużywa kredyt | Nie | Tak, jeden |
| Walidacja i sprawdzenie, czy tekst się mieści | Tak | Tak |
| Weryfikacja treści | Tak | Tak |
| Najdalszy status | `queued` lub `rejected` | `sent` |
| Pisana i wysyłana | Nigdy | Tak |

Nie czekaj, aż pocztówka testowa osiągnie `sent`. Zatrzymuje się na `queued`.

## Co jest rozdzielone

| Obszar | Zachowanie |
| - | - |
| Pocztówki | Listy, panel i wyszukiwanie po ID pokazują tylko bieżący tryb. Pocztówka z drugiego trybu zwraca `404 Not Found`. |
| Klucze API | Panel pokazuje i unieważnia klucze tylko z bieżącego trybu. Limit 20 kluczy obejmuje oba tryby łącznie. |
| Klucze idempotency | Ten sam klucz możesz użyć raz w każdym trybie. |
| Limity żądań | Każdy tryb ma osobne liczniki z tymi samymi limitami. |
| Saldo kredytów | Wspólne. `available_credit_balance` zawsze pokazuje prawdziwe saldo; pocztówki testowe go nie zmieniają. |

## Lista kontrolna przed przejściem na live

**1. Wyłącz tryb testowy**

Użyj menu konta albo banera.

**2. Dodaj kredyty**

Sprawdź saldo w [Rozliczeniach](https://paperjoy.co/billing). Bez kredytów żądania live kończą się błędem `402`.

**3. Utwórz klucz live**

Zaczyna się od `pj_live_`. Przechowuj go obok klucza testowego, a nie zamiast niego.

**4. Podmień klucz i wyślij jedną prawdziwą kartkę**

Wyślij jedną pocztówkę do siebie i śledź jej status, zanim uruchomisz wysyłkę na większą skalę.

> [!WARNING]
>
> Klucz `pj_live_` składa prawdziwe zamówienia i zużywa kredyty. Nigdy nie używaj go w testach automatycznych ani w CI.


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