Schema

字段契约

OpenAPI 与 Webhook 共用稳定 Blogger 契约。对外不暴露内部组织和成员字段，结构化字段尽量保持结构，不自动合并成一个大字符串。

Blogger 对外字段

字段	类型	说明
`id`	string	达人记录 id
`platform`	BloggerPlatform	PGY / STARMAP / VIDEO_HUXUAN / MP_HUXUAN / BILIBILI_HUAHUO / KUAISHOU_JLJX
`platformBloggerId`	string	平台内达人 id
`nickname`	string	达人昵称
`fansCount`	number \| null	粉丝数
`interactRate`	number \| null	万分比，如 350 = 3.5%
`priceJson`	object \| null	结构化报价，不合并为大字符串
`tags`	string[]	对外输出标签数组
`rawData`	object \| array \| null	平台原始数据，保留结构
`source`	MANUAL \| IMPORT \| SCRAPE	数据来源
`createdAt / updatedAt`	string	ISO 字符串；增量同步以 updatedAt 作为对外变更时间

对外 Blogger 不包含 organizationId、ownerUserId 和内部采集调度字段。采集回传不承诺联系方式字段。

结构化 JSON 字段

JSON 对象的 key 必须使用英文 camelCase，不使用中文 key。中文只可作为展示文案或字段值。

字段	规则
`priceJson`	报价结构，按英文 camelCase 报价项拆 key，例如 imageText、shortVideo。
`rawData`	平台原始数据，允许 object 或 array，不要 JSON.stringify 后塞进字符串字段。
`tags`	对外应为 string[]。底层若仍是字符串，输出前需要解析。
`scope`	API Key 权限范围，如 { mode: "pull" }。
`headersJson`	Webhook 自定义 Header，保持 object。
`authConfigJson`	Webhook Bearer / Basic 配置，保持 object。

Excel / CSV 导出规则

priceJson 应按英文 key 拆列，例如 报价-imageText、报价-shortVideo。
嵌套对象或数组无法平铺时，才放入 报价-原始JSON。
rawData 不建议默认导出为单元格文本，除非用户明确选择原始数据。
展示层可以文本化，但 API / Webhook 契约必须保持结构化。