Arkloop Developers

账户 (Accounts)

所有端点需要 Bearer Token 认证。

创建账户(工作区)

POST /v1/accounts

请求体

字段类型必填说明
slugstring唯一标识符(URL 友好)
namestring显示名称

响应

{
  "id": "...",
  "slug": "acme-corp",
  "name": "Acme Corp",
  "type": "workspace",
  "created_at": "2024-01-01T00:00:00Z"
}

获取当前用户的账户列表

GET /v1/accounts/me

获取账户详情

GET /v1/accounts/{account_id}

获取账户用量(月度)

GET /v1/accounts/{account_id}/usage

查询参数同 GET /v1/me/usage


获取账户用量(按日)

GET /v1/accounts/{account_id}/usage/daily

获取账户用量(按模型)

GET /v1/accounts/{account_id}/usage/by-model

团队管理

创建团队

POST /v1/teams

请求体

字段类型必填
namestring

响应

{
  "id": "...",
  "account_id": "...",
  "name": "法务团队",
  "members_count": 0,
  "created_at": "2024-01-01T00:00:00Z"
}

列出团队

GET /v1/teams

删除团队

DELETE /v1/teams/{team_id}

列出团队成员

GET /v1/teams/{team_id}/members

响应

[
  {
    "team_id": "...",
    "user_id": "...",
    "role": "member",
    "created_at": "2024-01-01T00:00:00Z"
  }
]

添加团队成员

POST /v1/teams/{team_id}/members

请求体

字段类型必填说明
user_idstring
rolestringmemberadmin

移除团队成员

DELETE /v1/teams/{team_id}/members/{user_id}

邀请管理

发送邀请

POST /v1/accounts/{account_id}/invitations

请求体

字段类型必填说明
emailstring受邀邮箱
rolestring分配角色

响应

{
  "id": "...",
  "account_id": "...",
  "invited_by_user_id": "...",
  "email": "bob@example.com",
  "role": "member",
  "expires_at": "2024-02-01T00:00:00Z",
  "accepted_at": null,
  "created_at": "2024-01-01T00:00:00Z",
  "token": "..."
}

列出邀请

GET /v1/accounts/{account_id}/invitations

接受邀请

POST /v1/account-invitations/{token}/accept

响应

{ "ok": true }

撤销邀请

DELETE /v1/account-invitations/{invitation_id}