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

# Podgląd pocztówki

> Wygeneruj obraz PNG kartki przed zamówieniem. Za darmo i bez wysyłki.

`POST /api/postcards/preview` zwraca obraz kartki dokładnie takiej, jaką napisze robot. Użyj go, aby pokazać klientowi próbkę albo sprawdzić, czy dynamiczny tekst się mieści, zanim złożysz zamówienie.

```bash theme={null}
curl https://paperjoy.co/api/postcards/preview \
  --header "Authorization: Bearer $PAPERJOY_API_KEY" \
  --header "Accept: image/png" \
  --header "Content-Type: application/json" \
  --data '{
    "content": "Droga Anno,\ndziękujemy za pierwsze zamówienie! Mamy nadzieję, że kwiaty sprawiły Ci dużo radości. Do zobaczenia wiosną!",
    "signature": "Marta z Kwiaciarni Pod Lipą",
    "font_id": "font-1"
  }' \
  --output podglad.png
```

Odpowiedź to `200 OK` z `Content-Type: image/png`:

![Obraz PNG zwrócony przez endpoint podglądu: odręcznie zapisana kartka z wiadomością i podpisem.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/card-font-1-pl.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=9398ab490b5b8cd6a86847287899a189)

## Body żądania

Podgląd przyjmuje pola kartki z [Utwórz pocztówkę](https://docs.paperjoy.co/postcards/create.md). Nie wymaga odbiorcy ani adresu.

| Pole | Typ | Zasada |
| - | - | - |
| `content` | string | Wymagane. Do 300 znaków. |
| `font_id` | string | Wymagane. `font-1` lub `font-2`. |
| `signature` | string | Opcjonalne. Do 50 znaków. |
| `signature_id` | string | Opcjonalne. Aktywny [własny podpis](https://docs.paperjoy.co/postcards/custom-signatures.md). Nie łącz z `signature`. |
| `mistake` | boolean | Opcjonalne. Domyślnie `false`. |

## Warto wiedzieć

* **Za darmo.** Podgląd nigdy nie tworzy pocztówki ani nie zużywa kredytu, w żadnym trybie.
* **Tylko kartka.** Podgląd pokazuje stronę z odręcznym tekstem. Podgląd koperty jest dostępny w [edytorze](https://docs.paperjoy.co/integrations/editor.md).
* **Za długi tekst jest odrzucany, tak jak przy tworzeniu.** Podgląd zwraca ten sam błąd `422` `card_fit` co [utworzenie pocztówki](https://docs.paperjoy.co/postcards/create.md), więc odpowiedź `200` oznacza, że zamówienie się zmieści.
* **Pomyłka jest powtarzalna.** Przy `mistake: true` ta sama wiadomość zawsze ma przekreślone to samo słowo, więc podgląd zgadza się z kartką.
* **Pamięć podręczna na 10 minut.** Identyczne żądania szybko zwracają ten sam obraz.
* **Limit żądań.** 30 podglądów na minutę. Zobacz [Limity](https://docs.paperjoy.co/reference/errors-and-rate-limits.md#limity).

> [!TIP]
>
> Przy tworzeniu pocztówki wyślij dokładnie te same `content`, `signature` lub `signature_id`, `font_id` i `mistake`, aby kartka była taka jak zatwierdzony podgląd.


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