文档中心 > API类目 > 聚安全API

alibaba.security.jaq.captcha.send (聚安全安全验证发起接口)

聚安全安全验证发起

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
captcha_type Number 必须 1 验证码发送渠道类型 1-短信 3-邮件
extend_data String 可选 {"screenHeight":100,"screenWidth":100} 扩展字段,格式为JSON字符串,用于传递“滚小球”等验证方式所需的额外入参,例如屏幕尺寸等,请参考示例
info_token String 必须 57a5c6ce-06c6-11e6-8ba5-a0d3c1f1fdf4 风险识别接口返回的信息口令
protocol_version String 必须 1.0 协议版本号
rsign String 可选 a3a6c0de6db6c85d1ec183e95f082f08 软token签名
rtken_index String 可选 c2607d757dcad439b94349e99fc6bab8 软token索引
utoken String 必须 Uk/41dHvLE4DALlys7tWlJuq UMID token

响应参数

名称 类型 示例值 描述
data JaqSendCaptchaResult 出参结构体
  • └ extend_data
  • String
  • {"ballInitX":56,"ballInitY":13,"holeInitX":33,"holeInitY":72,"ballRadius":48,"holeRadius":48}
  • 扩展字段,格式为JSON字符串,由于出参“滚小球”等验证方式所需的额外出参,例如小球位置坐标等,请参考示例
  • jaq_dispatch_param
  • JaqDispatchParam
  • 安全验证前向化下发参数结构体
  • └ event_id
  • String
  • 913235a6-efdc-11e5-8ba5-a0d3c1f1fdf4
  • 事件ID
  • └ protocol_version
  • String
  • 1.0
  • 协议版本号
  • └ rtken
  • String
  • NDI3MiZFZG81SVZJVHpYUUwrZlBKVlNPTU1nPT0
  • 下发的软token密文
  • └ rtken_index
  • String
  • aadffa525022d4d8a2ff15cac28334db
  • 下发的软token索引
  • └ send_status
  • Number
  • 10
  • 验证发起请求是否调用成功(及状态),约定正值为成功,负值为失败
  • └ session_id
  • String
  • 8c7b696e-efdc-11e5-8ba5-a0d3c1f1fdf4
  • 验证码会话ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSecurityJaqCaptchaSendRequest req = new AlibabaSecurityJaqCaptchaSendRequest();
req.setCaptchaType(1L);
req.setExtendData("{\"screenHeight\":100,\"screenWidth\":100}");
req.setInfoToken("57a5c6ce-06c6-11e6-8ba5-a0d3c1f1fdf4");
req.setProtocolVersion("1.0");
req.setRsign("a3a6c0de6db6c85d1ec183e95f082f08");
req.setRtkenIndex("c2607d757dcad439b94349e99fc6bab8");
req.setUtoken("Uk/41dHvLE4DALlys7tWlJuq");
AlibabaSecurityJaqCaptchaSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_security_jaq_captcha_send_response>
    <data>
        <extend_data>{&quot;ballInitX&quot;:56,&quot;ballInitY&quot;:13,&quot;holeInitX&quot;:33,&quot;holeInitY&quot;:72,&quot;ballRadius&quot;:48,&quot;holeRadius&quot;:48}</extend_data>
        <jaq_dispatch_param>
            <event_id>913235a6-efdc-11e5-8ba5-a0d3c1f1fdf4</event_id>
            <protocol_version>1.0</protocol_version>
            <rtken>NDI3MiZFZG81SVZJVHpYUUwrZlBKVlNPTU1nPT0</rtken>
            <rtken_index>aadffa525022d4d8a2ff15cac28334db</rtken_index>
        </jaq_dispatch_param>
        <send_status>10</send_status>
        <session_id>8c7b696e-efdc-11e5-8ba5-a0d3c1f1fdf4</session_id>
    </data>
</alibaba_security_jaq_captcha_send_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.param-error 请求参数错误 检查请求入参
isp.server-error 服务端错误 稍后重试

API工具

如何获得此API

FAQ

返回
顶部