获取数字验证码

最近更新时间:2024-04-09 15:54:34

我的收藏

接口描述

使用数字活体检测模式前,需调用本接口获取数字验证码。

授权说明

通过子账号使用时,需要授予 ci:CreateGetLiveCodeJob权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制


请求

请求示例

GET /?ci-process=GetLiveCode HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>

说明
Authorization: Auth String,详情请参见 请求签名 文档。

请求参数

参数名称
描述
类型
是否必选
ci-process
数据万象处理能力,获取数字验证码固定为 GetLiveCode
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<LiveCode>数字验证码</LiveCode>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Response 的内容:
节点名称(关键字)
父节点
描述
类型
LiveCode
Response
数字验证码,如:1234
String

实际案例

请求

GET /?ci-process=GetLiveCode HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-cos-request-id: NWY2OWFlZjVfOTA0MDYzNjRfNjY5Zl8zNQ==

<Response>
<LiveCode>0521</LiveCode>
</Response>