查询组织列表
查询组织列表
支持查询当前开发者密钥所属账号可访问的组织列表。
可以通过该接口,查询当前开发者密钥所属账号可访问的组织列表。
请求方式
GET
调用地址
https://api.${endpoint}/v1/org/list
调用验证
使用账号级 DevKey / DevSecret 的 Basic 鉴权。
请求
请求示例
curl -X GET 'https://api.${endpoint}/v1/org/list' \
-H 'Authorization: Basic ${BASIC_TOKEN}'
curl -X GET 'https://api.${endpoint}/v1/org/list' \
-H 'Authorization: Basic ${BASIC_TOKEN}'
此代码块在浮窗中显示
请求头
| 字段 | 类型 | 说明 |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | 使用 DevKey:DevSecret Base64 后的 Basic Token。 |
请求参数
无。
响应
响应示例
{
"code": 0,
"message": "OK",
"data": [
{
"org_id": "p-xxxx",
"org_name": "Demo Org",
"is_owner": true
}
]
}
{
"code": 0,
"message": "OK",
"data": [
{
"org_id": "p-xxxx",
"org_name": "Demo Org",
"is_owner": true
}
]
}
此代码块在浮窗中显示
成功响应
| 字段 | 类型 | 说明 |
|---|---|---|
| org_id | String | 组织 ID,后续组织资源接口需要传入该字段。 |
| org_name | String | 组织名称。 |
| is_owner | Boolean | 当前账号是否为组织拥有者。 |
失败响应
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误码。 |
| message | String | 错误详情。 |
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误 |
| 401 | 未授权 |
| 403 | 权限不足 |
| 429 | 请求过于频繁 |
| 500 | 服务器错误 |
