- 文档
- 用户身份认证
- Log In via Authorization Code
Log In via Authorization Code¶
通过单点登录(SSO)的授权码登录。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.2/loginViaCode
请求参数(URI)¶
| 名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|---|
| channel | Query | 可选 | String | 用户登录来源。支持指定以下参数: 
 如需自定义其它登录来源,可联系系统管理员。 | 
请求参数(Body)¶
| 名称 | 必需/可选 | 数据类型 | 描述 | 
|---|---|---|---|
| code | 必需 | String | 授权码。 | 
响应参数¶
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| organizations | List<JSONObject> | 用户所在的 OU 列表。详见 IdNamePair 结构体。 | 
| user | List<JSONObject> | 用户信息,包含用户名称和 ID。IdNamePair 结构体 >> | 
IdNamePair 结构体¶
| 名称 | 数据类型 | 描述 | 
|---|---|---|
| id | String | 用户 ID 或 OU ID。 | 
| name | String | 用户名称或 OU 名称。 | 
错误码¶
| 代码 | 描述 | 
|---|---|
| 31400 | 授权码无效 | 
| 31429 | 密码或 IP 错误次数过多 | 
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.2/loginViaCode?channel=web
method: POST
requestBody:
{"code":"yourAuthorizationCode"}
返回示例¶
{
  "code": 0,
  "data": {
    "organizations": [
      {
        "id": "your_org_id",
        "name": "your_org_name"
      },
      {
        "id": "your_org_id_2",
        "name": "your_org_id_2"
      }
    ],
    "user": {
      "id": "your_user_id",
      "name": "your_user_name"
    }
  },
  "message": "OK"
}