# Paginasi

Daftar mengembalikan satu halaman item. Cara meminta halaman berikutnya tergantung daftarnya.

## Halaman cursor: post

[`GET /posts`](/api/operations/listposts/) mengembalikan sampai `limit` post (default 50 per status, 500 per rentang tanggal). Kalau
masih ada, respons membawa header `X-Next-Cursor`. Kirim kembali sebagai `cursor` dengan filter yang sama:

```sh
curl -i "https://postflow.biz.id/api/v1/posts?status=published&limit=100" -H "Authorization: Bearer $POSTFLOW_API_KEY"
# X-Next-Cursor: WzE3OTA4NTY…
curl "https://postflow.biz.id/api/v1/posts?status=published&limit=100&cursor=WzE3OTA4NTY…" -H "Authorization: Bearer $POSTFLOW_API_KEY"
```

Tanpa header berarti halaman terakhir. Cursor bersifat opaque: jangan dibuat atau diubah sendiri.

## Halaman timestamp: media dan komentar

[`GET /media`](/api/operations/listmedia/) (60 per halaman) dan [`GET /inbox`](/api/operations/listcomments/) (30 thread per
halaman) mengembalikan yang terbaru dulu. Untuk halaman berikutnya, kirim waktu item terakhir sebagai `before`:

| Daftar | Kirim sebagai `before` |
|---|---|
| `GET /media` | `createdAt` item terakhir |
| `GET /inbox` | `commentedAt` thread terakhir |

Halaman yang lebih pendek dari ukuran halaman adalah yang terakhir.

## Tanpa paginasi

`GET /inbox/messages` mengembalikan 60 percakapan terbaru; `GET /inbox/messages/{id}` 100 pesan terakhir. `GET /calendar`
mencakup maksimal 92 hari. Akun, tag, content type dan webhook adalah daftar pendek.

## Di MCP

Tool daftar mengembalikan `{ "items": [...], "nextCursor": "…" }`. Agent mengirim `nextCursor` kembali sebagai `cursor`.