号码认证 API
最近更新:2022-10-27

号码认证 API

功能说明

提交手机号码和 token,验证是否一致,同时识别手机号的业务风险分值。

调用地址

Android 和 iOS 使用

POST https://api.verification.jpush.cn/v2/web/verify

Web 使用

POST https://api.verification.jpush.cn/v2/web/h5/verify

调用验证

详情参见 REST API 概述的 鉴权方式 说明。

请求示例

以 POST https://api.verification.jpush.cn/v2/web/verify 为例:

curl --insecure -X POST -v https://api.verification.jpush.cn/v2/web/verify -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{ "token": "STsid0000001542695429579Ob28vB7b0cYTI9w0GGZrv8ujUu05qZvw", "phone": 15813554612, "exID": "1234566", "ip": "127.0.0.1" }'
          curl --insecure -X POST -v https://api.verification.jpush.cn/v2/web/verify -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d '{
    "token": "STsid0000001542695429579Ob28vB7b0cYTI9w0GGZrv8ujUu05qZvw",
    "phone": 15813554612,
    "exID": "1234566",
    "ip": "127.0.0.1"
}'

        
此代码块在浮窗中显示

请求参数

关键字 类型 选项 含义
token String 必填 运营商下发的 token
phone String 必填 待认证的手机号码
ip String 可选 sdk 端 ip
exID String 可选 开发者自定义的 id,非必填

响应示例

请求成功

{ "id": 117270465679982592, "code": 9000, "content": "verify consistent", "exID": "1234566", "score": 0 }
          {
    "id": 117270465679982592,
    "code": 9000,
    "content": "verify consistent",
    "exID": "1234566",
    "score": 0
}

        
此代码块在浮窗中显示

请求失败

{ "code": 9011, "content": "auth failed" }
            {
    "code": 9011,
    "content": "auth failed"
}

        
此代码块在浮窗中显示

响应参数

关键字 类型 含义
id Long 流水号,请求出错时可能为空
exID String 开发者自定义的 id,若请求时为空返回为空
score Integer 风险评分
code Integer 返回码
content String 返回码说明

返回 score 说明

  • score 字段表示当前号码的风险,分数越高,风险越大,取值范围为:[0, 900]。
  • 根据极光安全认证团队经验,score 字段值的业务含义如下(仅供参考,可根据实际场景调配):
风险等级 含义描述
0 低风险 正常放行
300 中风险 可标记观察用户后续行为再进一步决策
600 中高风险 可采取进一步安全验证,或直接进行业务限制
900 高风险 可直接进行业务限制
文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开