分页

获取 API 密钥

列表（GET /v1/posts、GET /v1/media）按从新到旧的顺序逐页返回。limit 设置每页大小，范围 1 到 100（默认 20）。

json
{
  "data": [ … ],
  "nextCursor": "WyIyMDI2LTEwLTI3VDE1OjExOjU5LjAxN1oiLCIx…"
}

将 nextCursor 作为 cursor 传入即可读取下一页。当没有 nextCursor 时，说明已到末尾。

javascript
let cursor;
do {
  const url = new URL('https://api.sofia-post.com/api/v1/posts');
  url.searchParams.set('limit', '100');
  if (cursor) url.searchParams.set('cursor', cursor);
  const page = await globalThis.fetch(url, { headers: { Authorization: `Bearer ${key}` } }).then((r) => r.json());
  handle(page.data);
  cursor = page.nextCursor;
} while (cursor);

游标是不透明的：不要自行构造或修改。不是 Sofia 返回的游标会返回 400 invalid_cursor。