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

# Śledzenie pocztówek

> Wyświetl listę pocztówek, pobierz jedną po ID i sprawdź, kiedy została nadana.

Odczyt pocztówek jest darmowy. Widzisz tylko pocztówki ze swojego konta i z trybu klucza API.

## Pobierz jedną pocztówkę

```bash theme={null}
curl https://paperjoy.co/api/postcards/pc_MXP7a4Ni0c \
  --header "Authorization: Bearer $PAPERJOY_API_KEY" \
  --header "Accept: application/json"
```

Odpowiedź ma ten sam kształt co [odpowiedź przy tworzeniu](https://docs.paperjoy.co/postcards/create.md). Z czasem zmieniają się pola:

**status** `string`

Etap realizacji pocztówki. Zobacz [Statusy pocztówek](https://docs.paperjoy.co/postcards/statuses.md).

**submitted\_at** `string | null`

Moment złożenia zamówienia, w formacie ISO 8601. `null`, dopóki pocztówka jest [szkicem](https://docs.paperjoy.co/postcards/drafts.md).

**sent\_at** `string | null`

Moment nadania w formacie ISO 8601. `null`, dopóki status nie zmieni się na `sent`.

**updated\_at** `string`

Ostatnia zmiana statusu.

| Odpowiedź | Kiedy |
| - | - |
| `200 OK` | Pocztówka jest Twoja i pochodzi z tego trybu. |
| `404 Not Found` | ID nie istnieje albo pocztówka należy do drugiego trybu. |
| `403 Forbidden` | Pocztówka należy do innego konta. |

## Lista pocztówek

```bash theme={null}
curl "https://paperjoy.co/api/postcards?per_page=50&page=1" \
  --header "Authorization: Bearer $PAPERJOY_API_KEY" \
  --header "Accept: application/json"
```

Zwraca pocztówki z trybu klucza, od najnowszych, po jednej stronie naraz. Tablica `data` zawiera pocztówki z tej strony.

**page** `integer` (default: 1)

Numer strony, od 1. Strona za końcem listy zwraca pustą tablicę `data`.

**per\_page** `integer` (default: 50)

Liczba pocztówek na stronie, od 1 do 100. Większa wartość zwraca `422 Unprocessable Content`.

**status** `string`

Zwraca tylko pocztówki o tym [statusie](https://docs.paperjoy.co/postcards/statuses.md), np. `draft`, aby wyświetlić [szkice](https://docs.paperjoy.co/postcards/drafts.md). Nieznana wartość zwraca `422`.

Obok `data` odpowiedź zawiera `links` z adresami stron `first`, `last`, `prev` i `next` oraz `meta` z polami `current_page`, `last_page`, `per_page` i `total`. Aby odczytać całą listę, pobieraj `links.next`, dopóki nie będzie `null`.

## Kiedy kartka została nadana

Paperjoy nie wysyła webhooków. Aby śledzić wysyłkę, sprawdzaj otwarte pocztówki według harmonogramu:

1. Zapisuj `id` każdej utworzonej pocztówki.
2. Co kilka godzin pobieraj pocztówki, które nie mają jeszcze statusu `sent` ani `rejected`.
3. Gdy `status` zmieni się na `sent`, zapisz `sent_at` i przestań sprawdzać tę pocztówkę.

Pocztówka zmienia status tylko kilka razy, więc sprawdzanie kilka razy dziennie w zupełności wystarczy.

> [!TIP]
>
> Zamiast pobierać całą listę, pobieraj pojedyncze pocztówki po ID. To rozwiązanie pozostaje szybkie, nawet gdy historia rośnie.

## W panelu

Strona **Panel** pokazuje te same pocztówki z ich statusem i pozwala filtrować je według statusu. Kliknij wiersz, aby zobaczyć podgląd kartki, identyfikator pocztówki i adres dostawy.

![Panel Paperjoy z wykresem zamówionych i wysłanych pocztówek oraz tabelą pocztówek z odbiorcami i statusami.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/app/dashboard.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=5e66eb08e84aa22bed9ce29a3d2c9981)


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