用途:在 Bundle.social 平台上完成两类导入工作——从已连接的社交账号导入历史帖子数据,以及通过 CSV 批量创建帖子。
认证与基础信息:请求头使用 x-api-key: <your-api-key>,基础地址为 https://api.bundle.social。技能要求不要直接调用 Bundle.social API,而是生成以占位符作为认证头的 curl 命令示例。参考文档包括 references/README.md(平台枚举与标准错误)、references/10-post-import.md(帖子历史导入端点)、references/11-post-csv-import.md(CSV 导入端点)。
历史导入能力:可启动导入(POST /api/v1/post-history-import/,参数含 teamId、socialAccountId、可选日期范围,支持 dateFrom、dateTo、importComments、importAnalytics);列出导入(可按 teamId、socialAccountId、status 过滤);按 importId 查询详情;查看含分析数据的已导入帖子;批量删除已导入帖子;对失败的导入进行重试(POST /api/v1/post-history-import/{importId}/retry)。
CSV 导入能力:以 multipart/form-data 上传 CSV(POST /api/v1/post-csv-import/);列出 CSV 导入记录;查询导入详情;查询处理状态;查看逐行结果(可按 SUCCESS/FAILED 过滤)。CSV 决定帖子结构,每行对应一条帖子;上传后异步处理,初始状态为 PENDING,需轮询状态端点。
典型流程:完整历史迁移为连接账号→启动导入→轮询至完成→查看帖子;分析回溯为带 importAnalytics: true 启动导入;CSV 批量发帖为准备 CSV→上传→监控状态→查看失败行并修正;失败后检查状态、修复问题再重试;迁移后可校验并批量删除以便重新导入。
限制与错误处理:导入可能因平台速率限制、认证问题或无效数据失败,需检查失败导入的 error 字段;CSV 行失败会给出详细错误与规范化后的负载,可据此修复并重新上传;重试端点仅对失败的导入有效。