组织列表

GET/v2/orgs

返回当前账号可访问的组织及其角色。

Bearer Token orgs:read api.demo.acme-cloud.dev

请求参数

共 4 项

page 可选查询

integer · 默认 1

页码，从 1 开始

page_size 可选查询

integer · 默认 20

每页条数，1–100

sort 可选查询

string

排序字段，前缀 - 表示降序

keyword 可选查询

string

组织名称模糊匹配

响应

2 种状态

200 OK

响应示例

{
  "total": 2,
  "items": [
    {
      "id": "org_2c91",
      "name": "Acme 研发中心",
      "plan": "enterprise",
      "member_count": 42,
      "role": "owner",
      "created_at": "2025-11-08T03:20:00Z"
    },
    {
      "id": "org_77aa",
      "name": "Acme 数据平台",
      "plan": "team",
      "member_count": 9,
      "role": "member",
      "created_at": "2026-04-19T11:02:00Z"
    }
  ]
}

代码示例

cURL

curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/orgs?page=1&page_size=20&sort=-created_at' \
  -H 'Accept: application/json'