企业主动拉
Pull客户系统用企业级 ZSK_API_KEY 调用 /open-api/*，适合批量同步、增量拉取和跨系统对账。
- 要求企业 dataMode = CLOUD
- Header: X-API-Key
- 支持 since + cursor 增量流
docs.zishutonggao.com
企业数据同步 OpenAPI 文档
这里统一说明紫薯通告的企业主动拉、采集主动推、达人列表导入和官方 Skill。所有对外数据以稳定 Blogger JSON 契约为准，结构化字段保持结构化，不默认合并成大字符串。
主动拉凭证ZSK_API_KEY
主动推凭证WEBHOOK_SECRET
API Basehttps://api.zishutonggao.com
主动拉模式CLOUD only
Quick Start
选择接入方式
采集主动推
WebhookBlogger 新增或更新后，紫薯通告按端点配置把标准 Blogger JSON 推到客户系统。
- 端点级 WEBHOOK_SECRET
- bloggers 永远是数组
- 失败 run 支持立即重推
达人列表导入
Import客户系统把自有达人名单写入紫薯通告，后续由采集任务补齐昵称、头像、粉丝、互动率和报价等公开或授权字段。
- platform + url 最小写入
- PGY 支持蒲公英/小红书/短链
- 单批最多 500 条
官方 Skill
AI面向 Claude Code / Cursor 等 AI IDE，自动生成 Webhook 接收端、REST client 和增量同步脚本。
- Node / Python / Java Webhook 示例
- REST 主动拉 client
- LOCAL/CLOUD 模式守卫
Shortcuts
常用入口
Pull APIs
/open-api/* 接口清单
| Method | Path | 说明 |
|---|---|---|
GET | /open-api/organizations/self | 当前企业与调用配额 |
POST | /open-api/bloggers | 单条导入或更新达人 |
POST | /open-api/bloggers/batch | 批量导入或更新达人 |
POST | /open-api/bloggers/deactivate | 停用/归档达人 |
GET | /open-api/bloggers | 达人列表 |
GET | /open-api/bloggers/:id | 达人详情 |
GET | /open-api/bloggers/changes | 增量变更流 |
GET | /open-api/bloggers/:id/stats | 达人所属平台统计快照 |
GET | /open-api/scraping-tasks | 采集任务列表 |
GET | /open-api/scraping-tasks/:id | 采集任务详情 |
GET | /open-api/scraping-tasks/:id/runs | 采集任务运行历史 |
GET | /open-api/sync-runs | Webhook 推送运行记录 |
GET | /open-api/sync-runs/:id | 单次 Webhook 推送详情 |
GET | /open-api/import-runs | 达人列表导入批次 |
GET | /open-api/import-runs/:id | 单次导入批次详情 |