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

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

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

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

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 83359fd73fe94948385f570e3c139105headers.put("Authorization", "APPCODE " + appcode);//根据API的要求，定义相对应的Content-Typeheaders.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	非本网手机号码