status pokazuje, na jakim etapie jest pocztówka. Statusy zmieniają się tylko do przodu i nie można ich ustawić przez API. Szkic idzie dalej dopiero po wysłaniu.
Wszystkie statusy
Mogą pojawić się nowe statusy. Każdą nieznaną wartość traktuj jako „w realizacji”, zamiast zgłaszać błąd.
Szkice
Pocztówka utworzona z"draft": true zaczyna jako draft. Szkice są darmowe, roboty nigdy ich nie pobierają, a submitted_at ma wartość null. Gdy wyślesz szkic, Paperjoy pobiera jeden kredyt, ustawia submitted_at, a pocztówka przechodzi do new. Szkice, które nie zmieniły się przez 30 dni, są usuwane.
Każda pocztówka zamówiona bezpośrednio, bez szkicu, ma submitted_at równe czasowi utworzenia.
Odrzucone
Każda wiadomość przechodzi automatyczną weryfikację treści przed realizacją. Jeśli zostanie uznana za obraźliwą lub szkodliwą, pocztówka trafia do statusurejected:
- Nic nie zostanie napisane ani wysłane.
- W przypadku pocztówek live kredyt automatycznie wraca na Twoje saldo.
- Możesz wysłać przeredagowaną wiadomość jako nową pocztówkę z nowym
Idempotency-Key.
Pocztówki testowe
Pocztówki testowe także przechodzą weryfikację treści, więc trafiają doqueued lub rejected. Nigdy nie idą dalej i nigdy nie są pisane ani wysyłane.
Wysłane
Gdy pocztówka osiągnie statussent, pole sent_at zawiera moment przekazania jej Poczcie Polskiej. Dalej dostawa przebiega jak w przypadku zwykłego listu krajowego.