全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件

查询认证状态

更新时间:2018-05-02 16:50:16

描述

接口名称GetStatus

功能描述: 查询指定业务场景Biz,和指定认证 IDTicketId的认证状态。

名词解释

  • 业务场景 Biz: 表示使用实人认证服务的业务场景,请先参考 业务设置 在控制台上完成创建。
  • 认证 ID TicketId: 标识一次认证任务的唯一 ID,通常由业务使用方指定,方便关联业务场景的其他内容。
  • 认证状态: 表示一个认证任务所处的认证状态,主要有以下四种状态:
    • -1: 未认证,表示没有提交记录。
    • 0: 认证中,表示已提交认证,系统正在审核认证资料。
    • 1: 认证通过,表示最近一次提交的认证资料通过审核,当前认证任务完结。
    • 2: 认证不通过,表示最近一次提交的认证资料未通过审核,当前认证任务还可以继续发起提交。
  • 实人可信分: 表示根据认证过程中所提交的材料所判断出的“这个是真实自然人”的可信程度分值,取值范围为 [0,100],分数越大可信程度越高。
  • 人脸相似度分: 表示认证过程中所提交的人脸照片和身份证上的头像的相似程度分值,取值范围为 [0,100],分数越大相似度越高。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值: GetStatus
RegionId String 系统规定参数。取值: cn-hangzhou
Biz String 参看名词业务场景
TicketId String 参看名词认证 ID
注意: 需要与当前认证任务在 发起认证请求(GetVerifyToken) 时的认证 ID保持一致。

返回参数

名称 类型 是否必须 描述
StatusCode Integer 参看名词认证状态
TrustedScore Float 参看名词实人可信分
注意:接入方式为“无线SDK+服务端接入”的认证场景,且在实人认证管理控制台中启用实人可信分,这个值才有意义。
SimilarityScore Float 参看名词人脸相似度分
注意:只有提交的认证资料中同时包含人脸照片和身份证人像面照片,这个值才有意义。
AuditConclusions String 认证状态为认证不通过时的原因描述。

错误码说明

错误代码 英文描述 中文描述 HTTP 状态码
Error.InternalError The request processing has failed due to some unknown error. 服务内部出现未知错误,请联系技术支持排查。 500
InvalidParam.ParamMissing Please check if there is param empty in your imput. 参数错误,请检查参数是否为空。 400
Error.NoPermissionAccess No permission to access our service. 没有权限访问服务,请确认是否服务已开通。 403
InvalidParam.InvalidBiz The biz is not valid. 参数Biz不合法,请与控制台上创建的保持一致。 400

示例

使用 SDK 开发包示例

参看 SDK 开发包使用文档中的认证方案示例:JavaPHPPython.NETNode.jsGo

拼接 HTTPS 请求示例

请求示例

  1. https://cloudauth.aliyuncs.com/?Action=GetStatus
  2. &RegionId=cn-hangzhou
  3. &Biz=RPBasic
  4. &TicketId=39ecf51e-2f81-4dc5-90ee-ff86125be683
  5. &<[公共请求参数]>

返回示例

XML 格式:

  1. <?xml version='1.0' encoding='UTF-8'?>
  2. <GetStatusResponse>
  3. <Data>
  4. <StatusCode>1</StatusCode>
  5. <TrustedScore>87.15</TrustedScore>
  6. <SimilarityScore>93.12</SimilarityScore>
  7. <AuditConclusions>
  8. 不通过原因(包括但不限于以下几种情况):1、身份证照片模糊,光线问题造成字体无法识别;2、身份证照片信息与认证提交信息不一致;3、提交的照片非身份证照片。建议:请按引导提交本人有效身份证照片。
  9. </AuditConclusions>
  10. </Data>
  11. <Success>true</Success>
  12. <Code>1</Code>
  13. </GetStatusResponse>

JSON 格式:

  1. {
  2. "Data": {
  3. "SimilarityScore": 93.12,
  4. "TrustedScore": 87.15,
  5. "StatusCode": 1,
  6. "AuditConclusions": "不通过原因(包括但不限于以下几种情况):1、身份证照片模糊,光线问题造成字体无法识别;2、身份证照片信息与认证提交信息不一致;3、提交的照片非身份证照片。建议:请按引导提交本人有效身份证照片。"
  7. },
  8. "Success": true
  9. }
本文导读目录