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

alibaba.security.jaq.loginprevention.result.fetch (获取登录保护结果)

获取登录保护结果

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
id_number String 可选 18800777777777777777 账号绑定的身份证号
sdk_token String 可选 3b730b4f-1572-4de1-9770-a11c1cf0a4d0 接入无线保镖安全组件后从服务端获取的token
account_exist Number 可选 1 账号在系统里面是否存在。0:不存在;1:存在
address String 可选 浙江阿里巴巴 账号绑定的注册的地址
agent String 可选 Mozilia 发送HTTP请求的代理
bank_card_number String 可选 6225 XXXX XXXX XXXX 账号绑定的银行卡号
company_name String 可选 淘宝 账号绑定的公司名字
cookie String 可选 4SOMZWCI-LXU15 Cookie
current_url String 可选 http://jaq.alibaba.com 当前操作的页面URL。Source为1,2时,该参数必选
email String 可选 jaq@jaq.alibaba.com 关联账号的email。【phone_number ,email, (user_id,id_type)三种必选其一】
extend_data String 可选 {} 扩展字段。json格式的字符串,根据具体情况而定 。
id_type Number 可选 1 账号的全局唯一标识,为了提高准确率,建议带上该字段。【phone_number ,email, (user_id,id_type)三种必选其一】
ip String 必须 10.10.10.1 登录时候的IP地址
js_token String 可选 35679566 接入JS后获取的token
login_type Number 可选 1 登录场景。1:账密登陆;2:扫码登录;3:短信验证码登录;0:其它
mac_address String 可选 3E0-77A-BC6-F8D-110-3C6 硬件信息
password_correct Number 可选 1 密码是否正确。0:不正确;1:正确
password_hash String 可选 4d5c01842f37d90651f9693783c6564279fed6f4 将密码加盐hash后传递,用于弱密码检测
phone_number String 可选 13033338907 关联账号的手机号。手机号码的格式为国家码-手机号的格式,如中国手机号86-13088889999或美国手机号001-9096185426,如果不加国家码都视为中国手机号码【phone_number ,email, (user_id,id_type)三种必选其一】
protocol_version String 必须 1.0 协议版本号。现在的值是1.0
referer String 可选 http://jaq.alibaba.com 上一跳信息
register_date Number 可选 1450596239 注册的时间(秒)
register_ip String 可选 10.10.10.1 注册时候的ip
session_id String 可选 EF6YBX1WO2-SBX6XU62O60TJ0W6TMMW2-BUYTHCJI-UWCT Session id
source Number 必须 3 登录来源。1:PC网页;2:移动网页;3:APP;4:其它
user_id String 可选 887755 账号的全局唯一标识,为了提高准确率,建议带上该字段。【phone_number ,email, (user_id,id_type)三种必选其一】
user_name String 可选 jaqniu 账号绑定的呢称

响应参数

名称 类型 示例值 描述
jaq_account_risk_result JaqAccountRiskResult {} 账号风控返回结果
  • data
  • JaqAccountRiskData
  • {}
  • 风控结果的真正数据内容
  • captcha_check_data
  • CaptchaCheckData
  • UI验证所需的信息
  • └ captcha_client_need_info
  • String
  • {"phone":"*******9901","infoToken":"008d62d9-8ffb-4024-b222-28efb5cf4aea"}
  • 发起端上验证需要的信息
  • └ captcha_type
  • Number
  • 1
  • 推荐的验证类型,0-放行 1-短信下行 2-语音验证 3-滑动验证 4-实人认证 32-综合(滑动+语音) 9-阻断
  • detail
  • JaqAccountRiskDetailItem []
  • []
  • 详情列表
  • └ decision
  • Number
  • 1
  • 决定,0:可以接受;1:应该拒绝;2:需要人工审查
  • └ id
  • String
  • 756
  • rule id
  • └ name
  • String
  • 同人同机
  • rule name
  • └ score
  • Number
  • 20
  • 分数
  • └ event_id
  • String
  • 00035fcf-db31-4f3d-8faf-1217ffe7330f
  • 事件id
  • └ final_decision
  • Number
  • 2
  • 最终决定。0:可以接受;1:应该拒绝;2:需要人工审核
  • └ final_desc
  • String
  • renji_shuku
  • 综合风险描述
  • └ final_score
  • Number
  • 90
  • 最终得分
  • └ user_id
  • String
  • 9009090
  • 注册用户id
  • └ umid
  • String
  • 07058a21d2363164ccacd7275c92cc1339fdc148
  • umid

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSecurityJaqLoginpreventionResultFetchRequest req = new AlibabaSecurityJaqLoginpreventionResultFetchRequest();
req.setIdNumber("18800777777777777777");
req.setSdkToken("3b730b4f-1572-4de1-9770-a11c1cf0a4d0");
req.setAccountExist(1L);
req.setAddress("浙江阿里巴巴");
req.setAgent("Mozilia");
req.setBankCardNumber("6225 XXXX XXXX XXXX");
req.setCompanyName("淘宝");
req.setCookie("4SOMZWCI-LXU15");
req.setCurrentUrl("http://jaq.alibaba.com");
req.setEmail("jaq@jaq.alibaba.com");
req.setExtendData("{}");
req.setIdType(1L);
req.setIp("10.10.10.1");
req.setJsToken("35679566");
req.setLoginType(1L);
req.setMacAddress("3E0-77A-BC6-F8D-110-3C6");
req.setPasswordCorrect(1L);
req.setPasswordHash("4d5c01842f37d90651f9693783c6564279fed6f4");
req.setPhoneNumber("13033338907");
req.setProtocolVersion("1.0");
req.setReferer("http://jaq.alibaba.com");
req.setRegisterDate(1450596239L);
req.setRegisterIp("10.10.10.1");
req.setSessionId("EF6YBX1WO2-SBX6XU62O60TJ0W6TMMW2-BUYTHCJI-UWCT");
req.setSource(3L);
req.setUserId("887755");
req.setUserName("jaqniu");
AlibabaSecurityJaqLoginpreventionResultFetchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_security_jaq_loginprevention_result_fetch_response>
    <jaq_account_risk_result>
        <data>
            <captcha_check_data>
                <captcha_client_need_info>{&quot;phone&quot;:&quot;*******9901&quot;,&quot;infoToken&quot;:&quot;008d62d9-8ffb-4024-b222-28efb5cf4aea&quot;}</captcha_client_need_info>
                <captcha_type>1</captcha_type>
            </captcha_check_data>
            <detail>
                <jaq_account_risk_detail_item>
                    <decision>1</decision>
                    <id>756</id>
                    <name>同人同机</name>
                    <score>20</score>
                </jaq_account_risk_detail_item>
            </detail>
            <event_id>00035fcf-db31-4f3d-8faf-1217ffe7330f</event_id>
            <final_decision>2</final_decision>
            <final_desc>renji_shuku</final_desc>
            <final_score>90</final_score>
            <user_id>9009090</user_id>
            <umid>07058a21d2363164ccacd7275c92cc1339fdc148</umid>
        </data>
    </jaq_account_risk_result>
</alibaba_security_jaq_loginprevention_result_fetch_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

返回
顶部