用途:该技能覆盖 Bundle.social 上社交媒体帖子的完整生命周期,包括创建、发布、编辑与删除,可跨 14 个平台操作。
主要能力:一个帖子对象可同时面向多个平台,每个平台拥有独立的内容配置(文本、媒体、发布时间等),并支持草稿、定时、发布中、已发布、失败等状态管理。提供列表、创建、查询单条、更新、删除、重试发布六类端点。
使用方式:认证使用请求头 x-api-key: <your-api-key>,基础地址为 https://api.bundle.social。需先阅读 references/README.md 了解平台枚举与标准错误,阅读 references/06-post.md 了解端点细节。使用时根据目标平台构建对应内容块,设置立即发布或定时发布;仅在生成示例时输出 curl 命令,并以 <your-api-key> 作占位符,不要实际调用 API。
端点:GET /api/v1/post/ 列表(支持 teamId、status、offset、limit、search);POST /api/v1/post/ 创建;GET /api/v1/post/{id} 获取单条;PATCH /api/v1/post/{id} 更新;DELETE /api/v1/post/{id} 删除;POST /api/v1/post/{id}/retry 重试失败发布。
常见模式:创建并发布后通过 GET 检查状态;定时发布后按状态过滤核对并按需编辑;失败时定位失败平台后重试并监控;用 search 与状态筛选在大集合中查找帖子。
限制与注意事项:失败帖子状态为 failed,需用重试端点;400 响应中的 issues 数组含校验错误;429 速率限制按组织计算,批量操作前应检查组织用量;平台级发布错误出现在帖子的平台数据中。