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

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

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

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

1.用户验证与联系：

（1）电商平台在用户注册或修改重要信息时，可以通过手机在网状态接口验证用户手机号码的有效性。如果手机处于无法连接网络或不在网状态，可能提示用户检查手机状态或更换联系方式，以确保能够及时与用户取得联系，如发送订单确认信息、物流配送通知等。

（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	非本网手机号码