常见问题

主动拉和主动推能同时使用吗？

可以。主动拉用于批量同步、补偿和对账；主动推用于实时变更通知。两套凭证独立。

LOCAL 模式为什么不能主动拉？

LOCAL 模式下达人数据按成员隔离，没有企业共享池可作为开放接口输出，因此 /open-api/* 固定返回 403。主动推不受此限制。

Webhook 的 WEBHOOK_SECRET 能再次查看吗？

不能。创建端点时明文只展示一次。丢失后建议新建端点或后续使用轮换能力。

batchSize = 1 时 bloggers 是对象还是数组？

始终是数组。客户接收端应统一按 payload.bloggers 数组处理。

priceJson 可以当字符串处理吗？

不建议。它是结构化报价字段，API 与 Webhook 应保持 object。只有 Excel/CSV 展示层可以拆列或兜底展示 JSON 文本。

官方 Skill 和这个文档站哪个是准的？

文档站与官方 Skill 会同步更新。若你看到两边内容不一致，请先刷新文档站页面， 并将官方 Skill 更新到最新版本后再使用。

npx skills check
npx skills update