API REFERENCE
用户管理 API
管理翠鸟团队成员账号、角色权限与 API 访问令牌
用户角色与权限
翠鸟采用基于角色的访问控制（RBAC），每个团队成员的操作权限由其角色决定。
| 角色 | 描述 | 可访问功能 |
|---|---|---|
owner | 账号所有者 | 全部功能，含账单管理与账号删除 |
admin | 管理员 | 全部功能，不含账单与账号级设置 |
editor | 内容编辑 | 创建/编辑内容，查看分析数据 |
sales | 销售人员 | 查看/更新线索，不可修改内容 |
viewer | 只读用户 | 仅查看内容和数据，不可修改 |
用户端点
| 方法 | 路径 | 描述 |
|---|---|---|
GET | /v1/users | 列出团队所有成员 |
GET | /v1/users/me | 获取当前 API Key 关联的用户信息 |
GET | /v1/users/{id} | 获取指定用户详情 |
POST | /v1/users/invite | 邀请新成员加入团队 |
PATCH | /v1/users/{id} | 更新用户角色或信息 |
DELETE | /v1/users/{id} | 移除团队成员 |
邀请成员与更新角色
邀请新成员
curl -X POST https://api.cuiniao.com/v1/users/invite \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"email": "new.member@company.com",
"role": "editor",
"name": "王芳"
}'
被邀请成员将收到一封激活邮件，点击链接后完成注册并加入团队。邀请链接有效期为 72 小时。
更新成员角色
curl -X PATCH https://api.cuiniao.com/v1/users/user_sales_001 \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"role": "admin"
}'
只有
owner 角色可以更改其他成员的角色。admin 可以邀请和移除成员，但不能修改 owner 的角色。API Key 管理
每个用户可创建多个 API Key，建议为不同用途（开发环境、生产环境、第三方集成）创建独立的 Key。
# 创建新 API Key
curl -X POST https://api.cuiniao.com/v1/users/me/api-keys \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "CRM集成专用Key",
"permissions": ["leads:read", "leads:write", "analytics:read"]
}'
# 撤销指定 API Key
curl -X DELETE https://api.cuiniao.com/v1/users/me/api-keys/key_8mZp3nQr \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx"
权限范围（permissions）支持细粒度控制，格式为 resource:action，如 leads:read、resources:write、analytics:read。