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

# Treść i wygląd kartki

> Ile tekstu się zmieści, jak działają podziały linii oraz jak wybrać pismo i podpis.

Każda pocztówka Paperjoy to kartka A6 (148 × 105 mm) zapisana prawdziwym długopisem. Wiadomość zaczyna się u góry, a podpis jest w lewym dolnym rogu. Z każdej strony zostaje 8 mm wolnego marginesu.

Wszystkie przykłady na tej stronie to prawdziwe podglądy z renderera Paperjoy.

## Wiadomość

| Zasada | Wartość |
| - | - |
| Długość | Do 300 znaków |
| Podziały linii | Zachowane dokładnie, także puste linie |
| Zawijanie | Automatyczne, między słowami |
| Znaki | Litery, cyfry, interpunkcja i polskie znaki (ą, ć, ę, ł, ń, ó, ś, ź, ż) |

### Podziały linii

Użyj `\n` w JSON (lub Enter w edytorze), aby zacząć nową linię. Pusta linia (`\n\n`) dodaje odstęp między akapitami.

```json theme={null}
{
  "content": "Cześć Piotrze!\n\nWszystkiego najlepszego z okazji urodzin.\n\nŚciskamy,"
}
```

![Pocztówka z trzema krótkimi akapitami oddzielonymi pustymi liniami: Cześć Piotrze!, Wszystkiego najlepszego z okazji urodzin., Ściskamy,](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-newlines-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=e716b7f6f103259b113180ab827f84d1)

### Żeby tekst się zmieścił

Paperjoy pisze największym rozmiarem, który się mieści. Dłuższe wiadomości są pisane nieco mniejszym pismem, do 75% normalnej wielkości. Jeśli tekst nadal się nie mieści, Paperjoy odrzuca pocztówkę błędem `422`, zamiast obcinać Twoją wiadomość:

```json theme={null}
{
  "message": "The content does not fit on the postcard. Shorten it or remove blank lines.",
  "errors": {
    "content": ["The content does not fit on the postcard. Shorten it or remove blank lines."]
  }
}
```

Najwięcej miejsca zostawiają krótkie słowa, niewiele pustych linii i krótki podpis. Około 200 znaków to wygodna długość dla większości kartek.

> [!TIP]
>
> [Zobacz podgląd kartki](https://docs.paperjoy.co/postcards/preview.md) przed zamówieniem. Gdy tekst się nie mieści, podgląd zwraca ten sam błąd `422`, więc sprawdzisz dynamiczny tekst bez zużywania kredytu.

## Pismo

Styl wybierasz polem `font_id`. Oba kroje obsługują polskie znaki.

> [tab] font-1 · Standardowe
>
> Czytelne, zaokrąglone pismo. W edytorze nazywa się **Standardowe**.
>
> ![Pocztówka zapisana krojem font-1, czytelnym prostym pismem.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-font-1-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=9398ab490b5b8cd6a86847287899a189)

> [tab] font-2 · Szybkie
>
> Pismo łączone, które wygląda jak pisane jednym ruchem. W edytorze nazywa się **Szybkie**.
>
> ![Ta sama pocztówka zapisana krojem font-2, płynnym pismem łączonym.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-font-2-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=343d813767449bda47b1e47af6f5f06c)

### Naturalna pomyłka

Ustaw `"mistake": true`, aby przekreślić jedno słowo i napisać je ponownie, tak jak robią to ludzie piszący ręcznie. Dzięki temu kartka wygląda mniej jak wydruk. Domyślnie `false`.

Paperjoy wybiera słowo na podstawie samej wiadomości, więc ten sam tekst zawsze dostaje tę samą poprawkę. Wiadomości z jednym słowem lub bez pasującego słowa są pisane bez pomyłki.

![Pocztówka, na której jedno słowo jest zamazane i napisane ponownie tuż za nim.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-mistake-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=4aca08edd19739caed0e672226be4702)

## Podpis

Wybierz jeden z dwóch rodzajów. Nie możesz wysłać obu na jednej pocztówce.

> [card] Podpis wpisany
>
> Wyślij `signature` z maksymalnie 50 znakami. Jest pisany w jednej linii tym samym pismem co wiadomość, więc musi się w niej zmieścić.

> [card] [Własny podpis](https://docs.paperjoy.co/postcards/custom-signatures.md)
>
> Wyślij `signature_id`, aby użyć swojego prawdziwego podpisu odwzorowanego ze skanu. Dostępny w planach Pro i Business.

Możesz też pominąć oba i zakończyć wiadomość swoim imieniem.

## Wskazówki

* **Zwracaj się po imieniu.** „Droga Anno” działa lepiej niż „Drogi Kliencie”. Pobierz imię z CRM lub formularza.
* **Ogranicz się do 2–4 zdań.** Krótkie notki wyglądają naturalnie i zawsze się mieszczą.
* **Napisz o czymś konkretnym.** Wspomnij zamówienie, spotkanie albo rocznicę.
* **Pomiń linki i kody.** Nikt nie przepisuje adresu URL z pocztówki. Lepiej sprawdzi się krótkie, łatwe do zapamiętania słowo.
* **Bądź uprzejmy.** Każda wiadomość przechodzi automatyczną weryfikację treści. Obraźliwe wiadomości są [odrzucane](https://docs.paperjoy.co/postcards/statuses.md#odrzucone), a kredyt wraca na saldo.


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