crebee-social-media-gateway（Crebee 社交媒体网关）

CreBee 社交媒体网关

统一 HTTP API 网关，让 AI Agent 自动化管理 12 个中国主流社交媒体平台。欢迎访问官网 https://www.crebee.cn 下载试用。

快速参考

认证

所有 API 请求需要在 Authorization 头中携带 Bearer token。

步骤 1：获取 Token

POST /galic/v1/auth/token

响应：

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2025-01-28T00:00:00.000Z",
  "createdAt": "2025-01-21T00:00:00.000Z"
}

提示：Token 创建后可长期使用，无需在每次调用接口前都重新创建。仅在 token 过期（见响应中的 expiresAt）或返回 401 时再重新获取即可。

步骤 2：在所有请求中使用 Token

POST /galic/v1/account/getAll
Authorization: Bearer <token>
Content-Type: application/json

通用约定

账号标识

大多数平台 API 需要指定操作哪个账号：

{
  "accountArgs": {
    "accountID": "string",
    "appAlias": "string"
  }
}

• accountID：账号唯一标识（从 account/getAll 获取）
• appAlias：平台标识（如 douyin、bilibili、xiaohongshu）

最佳实践：先调用 account/getAll 获取可用账号列表及其 ID。

日期参数

当 API 需要日期范围时（如 startDate、endDate）：

• 使用 ISO 8601 日期字符串："2025-01-21" 或 "2025-01-21T00:00:00.000Z"
• 时间间隔通常使用 Unix 时间戳(秒)

分页

许多列表 API 使用游标分页：

{
  "cursor": "0",
  "count": 20
}

核心 API

账号管理

内容发布

支持的内容类型:

• 视频 (video): 抖音、B站、快手、视频号、小红书、知乎、微博、百家号、头条号、企鹅号、网易号
• 图文 (image): 抖音、知乎、小红书、快手、头条号、视频号
• 文章 (article): 抖音、知乎、B站、百家号、头条号、公众号

发布支持实时进度追踪（WebSocket/SSE）、定时发布、平台特定参数配置。详见 references/publishing.md。

批量发布请求结构

{
  "contentType": "video | image | article",
  "commonForm": {
    /* 公共参数，见下方 */
  },
  "tasks": [
    {
      "taskId": "唯一任务ID（由调用方生成）",
      "accountId": "账号ID",
      "platform": "平台标识",
      "contentType": "video | image | article",
      "params": {
        /* 平台特定参数 */
      }
    }
  ]
}

视频公共参数 (commonForm)

图文公共参数 (commonForm)

文章公共参数 (commonForm)

发布示例：批量发布视频到多个平台

POST /galic/v1/platform/publish/batch
Authorization: Bearer <token>
Content-Type: application/json

{
  "contentType": "video",
  "commonForm": {
    "title": "我的第一个视频",
    "desc": "这是一个测试视频的描述",
    "videoPath": "/Users/demo/videos/test.mp4",
    "coverPath": "/Users/demo/videos/cover.jpg",
    "timing": 0
  },
  "tasks": [
    {
      "taskId": "douyin-1706044800-abc123",
      "accountId": "douyin_account_123",
      "platform": "douyin",
      "contentType": "video",
      "params": {
        "visibilityType": 0,
        "allowDownload": 1
      }
    },
    {
      "taskId": "bilibili-1706044800-def456",
      "accountId": "bilibili_account_456",
      "platform": "bilibili",
      "contentType": "video",
      "params": {
        "tid": { "fenqu_id": 160, "fenqu_name": "生活" },
        "copyright": 1,
        "tags": ["日常", "生活"],
        "pubType": 1
      }
    }
  ]
}

响应:

{
  "total": 2,
  "success": 2,
  "failed": 0,
  "results": [
    { "accountId": "douyin_account_123", "platform": "douyin", "status": "success" },
    { "accountId": "bilibili_account_456", "platform": "bilibili", "status": "success" }
  ]
}

重要: taskId 由调用方生成，用于关联 WebSocket/SSE 进度回调。建议格式：{platform}-{timestamp}-{random}。

取消发布任务

POST /galic/v1/platform/publish/cancelTask
Authorization: Bearer <token>
Content-Type: application/json

{
  "taskId": "douyin-1706044800-abc123"
}

发布记录

请求参数

account 结构:

请求示例

POST /galic/v1/publish-record/get-global-publish-record
Authorization: Bearer <token>
Content-Type: application/json

{
  "account": {
    "account_id": "douyin_account_123",
    "account_platform": "douyin"
  },
  "startTime": 1705968000,
  "endTime": 1706227200
}

响应:

[
  {
    "id": 1,
    "account_id": "douyin_account_123",
    "platform": "douyin",
    "content_type": "video",
    "title": "视频标题",
    "publish_status": "success",
    "publish_result_data": "{\"playCount\":1000,\"likeCount\":50,\"completePlayRate\":0.75}",
    "published_at": "2025-01-23T10:00:00.000Z",
    "account": {
      "account_id": "douyin_account_123",
      "account_platform": "douyin"
    }
  }
]

注意: publish_result_data 是 JSON 字符串，包含平台特定指标（如完播率、2s 跳出率等），需解析后使用。

支持的平台

平台详细文档

各平台 API 的详细参数和响应说明，请阅读对应的参考文件：

• references/platforms/douyin.md - 抖音 API（29 个端点）
• references/platforms/bilibili.md - B站 API（27 个端点）
• references/platforms/xiaohongshu.md - 小红书 API（14 个端点）
• references/platforms/kuaishou.md - 快手 API（17 个端点）
• references/platforms/weibo.md - 微博 API（8 个端点）
• references/platforms/gongzhonghao.md - 公众号 API（4 个端点）
• references/platforms/baijiahao.md - 百家号 API（14 个端点）
• references/platforms/toutiaohao.md - 头条号 API（11 个端点）
• references/platforms/qiehao.md - 企鹅号 API（5 个端点）
• references/platforms/wangyihao.md - 网易号 API（8 个端点）
• references/platforms/shipinhao.md - 视频号 API（9 个端点）
• references/platforms/zhihu.md - 知乎 API（15 个端点）

典型工作流

1. 获取认证 Token

   POST /galic/v1/auth/token

1. 获取可用账号

   POST /galic/v1/account/getAll
   Authorization: Bearer <token>
   Body: {}

> ⚠️ 注意：必须传递 body，即使没有参数也要传空对象 {}，否则请求可能失败。

1. 选择账号和平台

从账号列表中记录 account_id 和 account_platform

1. 调用平台 API

   POST /galic/v1/platform/douyin/getDataOverview
   Authorization: Bearer <token>
   Content-Type: application/json

   {
     "accountArgs": {
       "accountID": "<account_id>",
       "appAlias": "douyin"
     },
     "startDate": "2025-01-21",
     "endDate": "2025-01-28"
   }

错误处理

所有 API 返回标准 HTTP 状态码：

• 200 - 成功
• 400 - 请求参数错误
• 401 - 未授权（缺少或无效的 token）
• 500 - 服务器内部错误

错误响应格式：

{
  "code": 400,
  "raw": null,
  "message": "详细错误信息"
}