手机在网状态接口如何对接？（一）

一、什么是手机在网状态？

传入手机号码，查询该手机号的在网状态，返回内容有正常使用、停机、在网但不可用、不在网（销号/未启用/异常）、预销户等多种状态。

二、手机在网状态使用场景？

1.信贷审核：

（1）金融机构在审批贷款申请时，可以通过手机在网状态接口来验证申请人提供的联系信息的真实性。如果申请人提供的手机号码处于长期离线或异常在网状态（如频繁更换 SIM 卡等），可能存在欺诈风险。例如，一些不法分子可能会提供虚假联系方式来骗取贷款，通过查看手机在网状态可以作为一个风险评估的因素。

（2）对于信用贷款，金融机构可以结合手机在网时长等信息来辅助判断申请人的稳定性。一般来说，手机在网时长较长且状态稳定的用户，可能在生活和工作方面相对稳定，违约风险相对较低。例如，一个手机号码已经持续在网并正常使用多年，说明用户可能有较为稳定的生活轨迹和社交关系，更有可能按时偿还贷款。

2.反欺诈检测：

（1）在金融交易过程中，通过实时监测手机在网状态可以及时发现异常情况。例如，如果用户的账户在异地登录且此时其手机处于离线状态，这可能是账户被盗用的一个警示信号。金融机构可以立即采取措施，如暂时冻结账户并联系用户核实情况，以防止资金损失。

（2）当用户进行大额转账等敏感操作时，结合手机在网状态进行二次验证。如果手机处于无法正常连接网络的状态，金融机构可以暂停交易并提示用户检查网络或联系客服，确保交易是用户本人在正常情况下发起的，降低被诈骗分子利用的风险。

三、如何调用手机在网状态接口？

下面我们以快证API为例，通过Java调用该手机在网状态接口，以下为示例代码：

	public static void main(String[] args) {
	    String host = "https://kzmstatev1.market.alicloudapi.com";
	    String path = "/api-mall/api/mobile_status/check";
	    String method = "POST";
	    String appcode = "你自己的AppCode";
	    Map<String, String> headers = new HashMap<String, String>();
	    //最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
	    headers.put("Authorization", "APPCODE " + appcode);
	    //根据API的要求，定义相对应的Content-Type
	    headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
	    Map<String, String> querys = new HashMap<String, String>();
	    Map<String, String> bodys = new HashMap<String, String>();
	    bodys.put("mobile", "mobile");


	    try {
	    	/**
	    	* 重要提示如下:
	    	* HttpUtils请从
	    	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
	    	* 下载
	    	*
	    	* 相应的依赖请参照
	    	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
	    	*/
	    	HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);
	    	System.out.println(response.toString());
	    	//获取response的body
	    	//System.out.println(EntityUtils.toString(response.getEntity()));
	    } catch (Exception e) {
	    	e.printStackTrace();
	    }
	}

正确响应返回字段示例：

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "orderNo": "202406282055560705659",
        "result": "1",
        "province": "北京",
        "city": "北京",
        "channel": "移动",
        "resultMsg": "正常"
    }
}

result	结果状态描述
0	销号或未启用
1	正常
2	停机
3	在网但不可用
999	非本网手机号码