文档中心 > API类目 > 反欺诈风控API

taobao.collinafacade.nocaptcha.sig.authenticate (人机识别)

人机识别颁发签名串后,本接口负责向ISV提供签名串校验服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sig_authenticate_context SigAuthenticateContext 必须 签名串校验接口入参
  • └ access_key
  • String
  • 必须
  • 123456789012345678901234567890TB
  • 接入密码
  • └ app_key
  • String
  • 必须
  • CF_APP_1
  • 接入应用标识
  • └ remote_ip
  • String
  • 必须
  • 127.0.0.1
  • 接入应用采集到的最终用户ip
  • └ session_id
  • String
  • 必须
  • e60dfa0a84c7c67d286debc5d66b2c0e
  • collinaface JS分配的会话id
  • └ sig
  • String
  • 必须
  • 00E5DE6A00DB1CC3946EE63C46B751786
  • 签名串
  • └ token
  • String
  • 必须
  • 1429595340257.6729
  • 会话标识,由sip提供的tokenutil工具类生成

响应参数

名称 类型 示例值 描述
ret Number 0 服务出参
ret_detail SigAuthenticateResult 100 返回authenticateResult
  • └ code
  • String
  • 100
  • 100 验证通过 验证通过 200 服务器故障,此时ResultWrapper的success=false 服务自身正确识别的服务器故障行为,请视同验证通过处理 900 验证不通过 预留9XX做为扩展,901:NOPASS_USER_APP,应用方传入参数有误,如appkey与access_key不匹配等
  • └ msg
  • String
  • 验证通过
  • 错误描述消息
  • └ timestamp
  • Number
  • 1429265370735
  • 签名串生成的毫秒值(System.currentTimeMillis()).使用方自行判断此签名串是否已过期
  • └ detail
  • String
  • ceshi
  • detail

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CollinafacadeNocaptchaSigAuthenticateRequest req = new CollinafacadeNocaptchaSigAuthenticateRequest();
CollinafacadeNocaptchaSigAuthenticateRequest.SigAuthenticateContext obj1 = new CollinafacadeNocaptchaSigAuthenticateRequest.SigAuthenticateContext();
obj1.setAccessKey("123456789012345678901234567890TB");
obj1.setAppKey("CF_APP_1");
obj1.setRemoteIp("127.0.0.1");
obj1.setSessionId("e60dfa0a84c7c67d286debc5d66b2c0e");
obj1.setSig("00E5DE6A00DB1CC3946EE63C46B751786");
obj1.setToken("1429595340257.6729");
req.setSigAuthenticateContext(obj1);
CollinafacadeNocaptchaSigAuthenticateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<collinafacade_nocaptcha_sig_authenticate_response>
    <ret>0</ret>
    <ret_detail>
        <code>100</code>
        <msg>验证通过</msg>
        <timestamp>1429265370735</timestamp>
        <detail>ceshi</detail>
    </ret_detail>
</collinafacade_nocaptcha_sig_authenticate_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>

错误码解释

错误码 错误描述 解决方案
isp.remote-service-error 服务器内部错误. 客户端自行决定sig校验策略, 服务已不可用

API工具

如何获得此API

FAQ

返回
顶部