全部产品
Search
文档中心

阿里云验证码:服务端接入

更新时间:Jun 25, 2024

完成客户端接入后,您还需要在服务端调用VerifyIntelligentCaptcha接口,发起验证请求。本文介绍如何调用VerifyIntelligentCaptcha接口。

前提条件

已为您的阿里云账号创建AccessKey。如果尚未创建AccessKey,请参见创建AccessKey

重要

禁止直接使用主账号AccessKey,因为主账号AccessKey一旦泄露将威胁您所有云资源的安全。请使用子账号(RAM用户)AccessKey,有效降低AccessKey泄露的风险。使用阿里云验证码,您需要为子账号授予阿里云验证码权限(AliyunYundunAFSFullAccess)。

下载并安装SDK

  1. 根据您服务端的开发环境,在OpenAPI开发者门户的验证码服务端智能验证示例代码页面,下载对应语言版本的服务端SDK包。

    验证码2.0服务端代码集成支持Java、TypeScript、Go、PHP、Python、C#、Darabonba语言。

    image.png

  2. 解压SDK包,并加载到您的服务端工程中。

调用VerifyIntelligentCaptcha接口

说明

如果您在调用过程中遇到任何问题,请提交工单联系我们。

发起认证请求

  • 接口名:VerifyIntelligentCaptcha

  • 服务地址:captcha.ap-southeast-1.aliyuncs.com

    说明

    如果您的region是中国内地,服务器地址请调用captcha.cn-shanghai.aliyuncs.com

  • 请求方法:POST

  • 传输协议:HTTPS

  • 接口说明:客户端验证码配置完成后,在服务端调用本接口进行验证

请求参数

名称

类型

是否必选

描述

示例值

CaptchaVerifyParam

String

由验证码脚本回调的验证参数,直接将全部参数信息由客户端传给服务端即可。

警告

禁止对验证参数做任何修改,否则业务会报错。

{"sceneId":"xxxxxx","certifyId":"xxxxxx","deviceToken":"xxxxxxx==","data":"xxxxxx==","..."}

SceneId

String

由您服务端写入本次验证对应的场景ID,建议传入,尤其在多场景下,防止前端被篡改为其他场景。

Udw***d72

返回数据

名称

类型

描述

HTTP Status Code

Integer

HTTP状态码。更多信息,请参见返回参数说明

HTTP Body

RequestId

String

请求ID。

Success

Boolean

请求是否成功。

  • true:表示请求成功。

  • false:表示请求失败。

Code

String

返回码。更多信息,请参见返回参数说明

Message

String

返回详细信息。更多信息,请参见返回参数说明

Result

VerifyResult

Boolean

验证结果。

  • true:表示验证通过。

  • false:表示验证不通过。

VerifyCode

String

原因码。

  • F001:验证不通过。

  • F002:您传入的CaptchaVerifyParam参数为空。

  • F003:您传入的CaptchaVerifyParam格式不合法,请参考集成文档检查您的集成代码。

  • F004:控制台开启测试模式下的验证不通过。

  • F005:场景ID不存在。

  • F006:场景ID不归属该账户。

  • F007:验证超出时间限制。

  • F008:验证数据重复提交。

  • F009:检测到虚拟设备环境,请使用真实设备。

  • F010:同IP访问频率超出限制。

  • F011:同设备访问频率超出限制。

  • F012:您传入的SceneID与CaptchaVerifyParam内的场景ID不一致。

  • F013:您传入的CaptchaVerifyParam缺少参数。

返回参数HTTP Status CodeCodeMessage的详细说明,如下表所示。

HTTP Status Code

Code

Message

200

Success

成功。

400

MissingParameter

缺少必须参数。

401

InvalidParameter

参数不合法。

403

Forbidden.AccountAccessDenied

无权限,可能是未开通服务,或已欠费。

403

Forbidden.RAMUserAccessDenied

RAM用户无权限,请授权 AliyunYundunAFSFullAccess。具体操作,请参见为RAM角色授权

500

InternalError

系统内部错误,建议重试。如果仍然报错,请提交工单联系我们。