账号 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- 账号受速率限制
