企业主动拉

鉴权

所有真实接口都需要请求头：

GET /open-api/bloggers/changes?since=2026-05-01T00:00:00.000Z&limit=500
Host: api.zishutonggao.com
X-API-Key: zsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Key 由企业 Owner 在管理端「企业管理 → API Key」生成。明文只在创建或重置时展示一次， 后端仅保存不可逆 hash。

数据模式

{
  "code": 403,
  "message": "开启云端共享数据模式后可用"
}

主动推 Webhook 不受 dataMode 限制，二者是独立能力。

Cursor 分页

列表类接口返回 items、nextCursor、hasMore。 客户端应在 hasMore = true 时带上 cursor 继续请求。

{
  "items": [],
  "nextCursor": "eyJzb3J0S2V5Ijoi...",
  "hasMore": true
}

当前限流为单 Key 60 req/min，响应头包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset。

增量同步

推荐使用 GET /open-api/bloggers/changes，用 since 固定本轮窗口， 用 cursor 翻页，整轮成功后再推进客户系统自己的本地水位。

let cursor = null;
const since = await loadLocalWatermark();

do {
  const url = new URL('https://api.zishutonggao.com/open-api/bloggers/changes');
  url.searchParams.set('since', since);
  url.searchParams.set('limit', '500');
  if (cursor) url.searchParams.set('cursor', cursor);

  const page = await fetch(url, { headers: { 'X-API-Key': process.env.ZSK_API_KEY } });
  const body = await page.json();
  await upsertBloggers(body.data.items);
  cursor = body.data.nextCursor;
} while (cursor);

接口清单