手机在网时长查询接口如何对接？（一）

一、什么是手机在网时长查询接口？

传入手机号码，查询该手机号的在网时长，返回时间区间，支持携号转网号码查询。

二、手机在网时长查询接口适用于哪些场景？

例如：客户画像与精准营销

（1）对于电信运营商来说，通过分析用户的手机在网时长，可以更全面地了解客户特征。例如，长期在网（如 5 年以上）的用户往往对运营商有较高的忠诚度，运营商可以针对这类用户推出专属的高端套餐升级计划，提供更多的数据流量、增值服务（如高清视频会员等），以满足他们可能随着时间增长而变化的通信需求。

（2）企业在进行市场推广时，若目标客户是在网时长较短（如 1 年以内）的年轻群体，可能意味着他们对新的应用和服务有更高的尝试意愿。企业可以针对这类用户推广新的社交应用、在线娱乐平台等，通过与运营商合作提供定向的优惠活动，如新用户首月免费体验等，吸引他们使用并提高用户粘性。

三、如何利用Java实现接口对接？

下面我们以快证API为例，通过Java实现接口对接：

----该接口有免费试用，有需要的小伙伴可以购买测试----
接口地址：https://market.aliyun.com/apimarket/detail/cmapi00066588?spm=5176.730005.result.154.4e303524hP61B9#sku=yuncode6058800002


	public static void main(String[] args) {
	    String host = "https://kzmlinev1.market.alicloudapi.com";
	    String path = "/api-mall/api/mobile_online/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": {
        "result": "4",
        "orderNo": "202406291011288751887",
        "time": "[12,24)"
    }
}

result	time描述, 单位:月
0	查无此号或已注销
1	[0,3)
2	[3,6)
3	[6,12)
4	[12,24)
5	[24,+∞)