# 查询人脸实名认证二维码-ShowRealNameAuthQrCode
#### 功能介绍
客户在自建平台查询人脸实名认证二维码。
#### 接口约束
该接口使用客户AK/SK或者Token调用。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
当前API仅主账号可以调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ShowRealNameAuthQrCode)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
当前API调用无需授权。
#### URI
GET /v2/customers/real-name-auth-qrcode
#### 请求消息
**请求参数**
无。
**请求示例**
```
GET https://bss.myhuaweicloud.com/v2/customers/real-name-auth-qrcode HTTP/1.1
Content-Type: application/json
X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
```
#### 响应消息
**响应参数**
| 参数          | 参数类型   | 描述                                                                                                                                                                                                    |
|:---|:---|:---|
| error_code  | String | **参数解释：** 状态码。具体请参考[状态码]。只有失败才返回该字段。 **取值范围：** 最大长度：20                         |
| error_msg   | String | **参数解释：** 错误描述信息。只有失败才返回该字段。 **取值范围：** 最大长度：1000                                                                       |
| qr_code_url | string | **参数解释：** 人脸实名认证二维码地址。 说明： 该二维码仅限单次使用，扫描后将自动失效。若未在10分钟内完成扫描，系统将自动作废。 **取值范围：** 最大长度：512 |
   
**响应示例**
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  
{
    "qr_code_url": "https://xxxx"
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 错误描述        |
|:---|:---|:---|
| 403     | CBC.0151     | 访问拒绝。       |
| 403     | CBC.99007297 | 租户子账号无权限操作。 |
| 500     | CBC.0999     | 其他错误。       |
| 400     | CBC.0100     | 参数错误。       |