# Paperjoy > Dokumentacja Paperjoy: wysyłaj ręcznie pisane pocztówki z edytora, przez Zapier, MCP lub API. ## Pierwsze kroki - [Dokumentacja Paperjoy](https://docs.paperjoy.co/index.md): Wysyłaj ręcznie pisane pocztówki z edytora, przez Zapier, asystenta AI (MCP) lub REST API. - [Jak działa Paperjoy](https://docs.paperjoy.co/getting-started/introduction.md): Co dzieje się od Twojego zlecenia do pocztówki w skrzynce odbiorcy i który sposób wysyłki wybrać. - [Szybki start: pierwsza pocztówka przez API](https://docs.paperjoy.co/getting-started/quickstart.md): Wyślij pierwszą pocztówkę przez API w pięć minut, bezpiecznie w trybie testowym. - [Tryb testowy](https://docs.paperjoy.co/getting-started/test-mode.md): Zbuduj i sprawdź integrację bez zużywania kredytów i wysyłania prawdziwych pocztówek. - [Klucze API](https://docs.paperjoy.co/getting-started/authentication.md): Twórz, używaj, chroń i wymieniaj klucze, które uwierzytelniają API Paperjoy i Zapier. ## Sposoby wysyłki - [Edytor](https://docs.paperjoy.co/integrations/editor.md): Napisz i wyślij pocztówkę ręcznie w panelu Paperjoy, z podglądem kartki i koperty na żywo. - [Integracja Paperjoy z Zapier](https://docs.paperjoy.co/integrations/zapier.md): Wysyłaj odręczną pocztówkę automatycznie, gdy coś wydarzy się w formularzu, CRM lub sklepie. - [Serwer MCP Paperjoy dla Claude i asystentów AI](https://docs.paperjoy.co/integrations/mcp.md): Pozwól, by Claude lub inny asystent AI pisał, wysyłał i śledził odręczne pocztówki za Ciebie. ## Pocztówki - [Treść i wygląd kartki](https://docs.paperjoy.co/postcards/write.md): Ile tekstu się zmieści, jak działają podziały linii oraz jak wybrać pismo i podpis. - [Własne podpisy](https://docs.paperjoy.co/postcards/custom-signatures.md): Podpisuj każdą pocztówkę swoim odręcznym podpisem odwzorowanym ze skanu. - [Adres i koperta](https://docs.paperjoy.co/postcards/supported-countries.md): Jak podać odbiorcę i polski adres dostawy oraz jak ustawić adres zwrotny na kopercie. - [Podgląd pocztówki](https://docs.paperjoy.co/postcards/preview.md): Wygeneruj obraz PNG kartki przed zamówieniem. Za darmo i bez wysyłki. - [Utwórz pocztówkę](https://docs.paperjoy.co/postcards/create.md): Wszystkie pola POST /api/postcards, zasady walidacji i ponawianie bez ryzyka podwójnej wysyłki. - [Szkice pocztówek: przygotuj, sprawdź i wyślij później](https://docs.paperjoy.co/postcards/drafts.md): Zapisuj darmowe szkice, edytuj je i podglądaj, a potem wyślij. Kredyt pobierany przy wysyłce. - [Śledzenie pocztówek](https://docs.paperjoy.co/postcards/list-and-retrieve.md): Wyświetl listę pocztówek, pobierz jedną po ID i sprawdź, kiedy została nadana. - [Statusy pocztówek](https://docs.paperjoy.co/postcards/statuses.md): Każdy etap od zamówienia do skrzynki odbiorcy i co oznacza każdy status. ## Konto - [Kredyty i rozliczenia](https://docs.paperjoy.co/account/credits-and-billing.md): Jak działają kredyty, co kosztuje kredyt i jak plany obniżają cenę kartki. ## Dokumentacja API - [Przegląd API Paperjoy](https://docs.paperjoy.co/reference/introduction.md): Adres bazowy, uwierzytelnianie, konwencje i wszystkie publiczne endpointy API Paperjoy. - [Błędy i limity](https://docs.paperjoy.co/reference/errors-and-rate-limits.md): Co oznacza każdy błąd, które ponawiać i jakie limity obowiązują Twoje konto. - [Historia zmian](https://docs.paperjoy.co/changelog.md): Zmiany w API Paperjoy, integracjach i tej dokumentacji. ### Endpointy API - [Pobierz konto](https://docs.paperjoy.co/api-reference/konto/pobierz-konto.md): Zwraca uwierzytelnionego użytkownika i dostępne saldo kredytów. Wymaga uprawnienia `user:read`. - [Utwórz pocztówkę](https://docs.paperjoy.co/api-reference/pocztówki/utwórz-pocztówkę.md): Tworzy pocztówkę w trybie klucza API. Klucz `pj_live_` składa prawdziwe zamówienie i zużywa jeden kredyt. Klucz `pj_test_` tworzy darmową pocztówkę testową, która nigdy nie zostanie napisana ani wysłana. - [Podgląd pocztówki](https://docs.paperjoy.co/api-reference/pocztówki/podgląd-pocztówki.md): Renderuje stronę kartki z odręcznym tekstem jako PNG. Podgląd jest darmowy i nigdy nie tworzy zamówienia. Wymaga uprawnienia `postcards:write`. - [Lista pocztówek](https://docs.paperjoy.co/api-reference/pocztówki/lista-pocztówek.md): Zwraca Twoje pocztówki z trybu klucza API, od najnowszych, po jednej stronie naraz. Użyj `page` i `per_page`, aby przechodzić przez listę, i pobieraj `links.next`, dopóki nie będzie `null`. Wymaga uprawnienia `postcards:read`. - [Pobierz pocztówkę](https://docs.paperjoy.co/api-reference/pocztówki/pobierz-pocztówkę.md): Zwraca jedną z Twoich pocztówek. Pocztówka z drugiego trybu zwraca `404`. Wymaga uprawnienia `postcards:read`. - [Edytuj szkic](https://docs.paperjoy.co/api-reference/pocztówki/edytuj-szkic.md): Zmienia tylko przesłane pola szkicu. `null` czyści pole, a `address` i `recipient` są zastępowane w całości. Pocztówki, która nie jest szkicem, nie można zmienić (`409`). Pola spoza listy, np. `status`, zwracają `422`. Wymaga uprawnienia `postcards:write`. - [Usuń szkic](https://docs.paperjoy.co/api-reference/pocztówki/usuń-szkic.md): Trwale usuwa szkic. Wysłanych pocztówek nie można usunąć (`409`). Wymaga uprawnienia `postcards:write`. - [Wyślij szkic](https://docs.paperjoy.co/api-reference/pocztówki/wyślij-szkic.md): Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia `status` na `new` i `submitted_at`. Gdy sprawdzenie się nie powiedzie (`422`) albo brakuje kredytów (`402`), pocztówka zostaje sz… - [Lista podpisów](https://docs.paperjoy.co/api-reference/podpisy/lista-podpisów.md): Zwraca własne podpisy Twojej organizacji, od najnowszych, także te, które wciąż przygotowujemy. Wymaga uprawnienia `signatures:read`. - [Pobierz podpis](https://docs.paperjoy.co/api-reference/podpisy/pobierz-podpis.md): Zwraca jeden z podpisów Twojej organizacji. Wymaga uprawnienia `signatures:read`. - [Usuń podpis](https://docs.paperjoy.co/api-reference/podpisy/usuń-podpis.md): Usuwa podpis, aby nie można go było użyć na nowych pocztówkach. Nie wpływa na pocztówki, które już go używają. Wymaga uprawnienia `signatures:write`. ## OpenAPI Specs - [openapi](/en/openapi.yaml) - [openapi](/openapi.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (31 pages)](https://docs.paperjoy.co/_llms/en.txt): Documentation for English. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.