Paginasi

Cara menelusuri daftar post, media, komentar dan pesan yang panjang.

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

Halaman cursor: post

GET /posts 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:

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 (60 per halaman) dan GET /inbox (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.