Skip to content

账号 API

管理连接的社交媒体账号的参考。

概述

账号代表你连接的社交媒体配置文件。每个账号与一个平台关联,包含用于身份验证的加密凭证。

列出账号

获取所有连接的账号。

端点:

GET /api/accounts

查询参数:

  • platform(可选)- 按平台过滤
  • status(可选)- 按状态过滤

示例:

bash
# 获取所有账号
curl https://api.browserman.run/api/accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

# 仅获取 Twitter 账号
curl https://api.browserman.run/api/accounts?platform=twitter \
  -H "Authorization: Bearer YOUR_API_KEY"

响应:

json
{
  "success": true,
  "data": {
    "accounts": [
      {
        "id": "acc_abc123",
        "name": "my-twitter",
        "platform": "twitter",
        "status": "active",
        "authMethod": "cookies",
        "createdAt": "2024-01-10T08:00:00Z",
        "lastUsedAt": "2024-01-15T10:30:00Z"
      }
    ],
    "total": 1
  }
}

获取账号详情

获取特定账号的详细信息。

端点:

GET /api/accounts/:accountId

示例:

bash
curl https://api.browserman.run/api/accounts/acc_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

删除账号

永久删除账号及其所有数据。

端点:

DELETE /api/accounts/:accountId

示例:

bash
curl -X DELETE https://api.browserman.run/api/accounts/acc_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

账号状态

活跃

账号已连接并正常工作。

错误

账号有身份验证或连接问题。

常见错误代码:

  • AUTHENTICATION_FAILED - 凭证无效或过期
  • ACCOUNT_SUSPENDED - 平台暂停了账号
  • RATE_LIMITED - 账号受速率限制

下一步