号码认证 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	高风险	可直接进行业务限制