---
order: 2
navTitle: 确认授权
---
# 确认授权

用于在[开放授权应用](../trustedapps/README.md#开放授权应用)或者[静默授权应用](../trustedapps/README.md#静默授权应用)的应用ID获取用户授权过程中，用户主动点击授权。

供系统内部扩展授权界面以及二次开发使用。

## 调用说明

请求方式： `POST`\
请求url：`/api/oauth2/authorize`\
参数示例：

```json
{
    "appid": "r6ctvybuno",
    "cipherPassport": "a3ws46e5d7r68ft7gy8hu9ougiyfutycgvhj=",
    "captchId": "xerctvybunim",
    "captch": "535462",
    "userDirectory": "sys"
}
```

参数说明：

| 参数           | 必须 | 说明                                                                                                                                                                                        |
| :------------- | :--- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| appid          | 是   | [开放授权应用](../trustedapps/README.md#开放授权应用)或者[静默授权应用](../trustedapps/README.md#静默授权应用)的应用ID                            |
| cipherPassport | 是   | 为 `{user: "xxx", password:"123"}` 或者`{phone:"13112345678",code:"535342"}`格式的json字符串的Base64编码字符串，其中`user`：账号，`password`：账号密码，`phone`：手机号，`code`：短信验证码 |
| captchId       | 否   | 图片验证码的ID                                                                                                                                                                              |
| captchId       | 否   | 图片验证码,当使用密码登录时，输入错误达到系统设置次数，界面上展示图片验证码的时候需要传递                                                                                                   |
| userDirectory  | 否   | 用户类型，`sys`代表系统用户，`external`代表外部用户，默认为`sys`                                                                                                                            |

## 返回值说明

示例：

```json
{
    "errorCode": "notLogin",
    "message": "没有登录",
    "code": "w4ex5cr6tv7by8un"
}
```

参数说明：

| 参数      | 说明                                   |
| :-------- | :------------------------------------- |
| errorCode | 错误码                                 |
| message   | 错误文本提示                           |
| code      | 授权码，有效时间10分钟，切只能使用一次 |

`errorCode`说明

| errorCode              | 说明             |
| :--------------------- | :--------------- |
| notLogin               | 没有登录         |
| appNotFound            | 应用不存在       |
| userOrPasswordMismatch | 账号或者密码出错 |
| codeMismatch           | 短信验证码错误   |
| codeExpired            | 短信验证码过期了 |