手机在网时长[简]

企业专用个人高级认证场景认证

查询用户的手机卡自开通以来的使用时间（非上网时间）。

¥79.2

补贴后单价：

申请赠送05次

约¥0/次
一元试用150次

约¥0.02/次
亿元补贴
体验价99309次

约¥0.3204/次
新客户首购特惠4993327次

约¥0.15/次
亿元补贴
优惠价4992376次

约¥0.21/次
亿元补贴
限时价12996495次

约¥0.2/次
亿元补贴
采购价299915784次

约¥0.19/次

立即购买

产品功能
接口文档

功能介绍

时长查询

输入手机号码，返回对应的在网时长数据。

全国覆盖

覆盖全国范围内的电信、移动、联通三大运营商。

携号转网

支持携号转网号码查询，转网号码的在网时长会重新计算。

准确迅速

数据准确性高，响应速度快，满足实时查询需求。

数据安全

支持AES加密传输，保障信息安全。

稳定强大

7/24持续稳定，支持高并发访问，适应各种业务需求。

应用场景

运营商行业

运营商可以通过这个接口获取用户的在网时长数据，用于用户画像、精准营销、套餐推荐等。

关联接口：

运营分析

运营商可以使用接口统计分析手机号码在网时长的数据，了解用户的留存情况和用户生命周期，优化运营策略和服务。

大数据行业

可以深入分析用户的生活习惯和行为模式。通过获取大量用户的手机在网时长数据,企业可以发现用户的生活规律和互联网使用习惯,得出有价值的洞察和结论,为产品设计和决策提供支持。

关联接口：

产品参数

性能

月更新

更新频率

查得计费

计费模式

99%

数据覆盖

业务

60QPS

并发连接

平均300ms

回调时长

https/http

支持协议

使用流程

账号注册

点击「免费注册」输入手机号和验证码完成注册

立即注册

开通服务

开通相关的功能服务

查看服务

开发和联调

获取AppKey/AppSecret进行API调用

测试文档

开始使用

开始使用云客通的功能

开始使用

合作客户

服务保障

可靠安全

提供高可用、低延迟的服务，实施严格的安全措施，确保业务的稳定运行和数据安全。

服务专业

专业团队提供全方位的售前和售后服务，随时解决您的疑问和问题。

数据合规

严格遵守数据保护法规，官方直连获取数据，确保数据的合法、合规。

灵活持续

提供多样接口，并持续更新，以满足您不断变化的业务和商业需求。

接口文档

手机在网时长
加密版本

错误码

错误码列表

资源下载

接口文档下载

手机在网时长

接口地址：http://v.juhe.cn/mobileOnline/query

请求方式：get/post

返回类型：json

接口描述：输入手机号码，返回在网时长

接口调试： API测试工具

请求Header：

	名称	值
	Content-Type	application/x-www-form-urlencoded

请求参数说明：

	名称	必填	类型	说明
	key	是	String	在个人中心->我的数据,接口名称上方查看
	mobile	是	String	手机号

请求代码示例：

curl
PHP
Python
Go
C#
Node
Java
ObjectC

curl -k -i "http://v.juhe.cn/mobileOnline/query?key=key&mobile=18988888888"

<?php
/**
 * 966-手机在网时长 - 代码参考（根据实际业务情况修改）
 */
// 基本参数配置
$apiUrl = "http://v.juhe.cn/mobileOnline/query"; // 接口请求URL
$method = "GET"; // 接口请求方式
$headers = ["Content-Type: application/x-www-form-urlencoded"]; // 接口请求header
$apiKey = "您申请的调用APIkey"; // 在个人中心->我的数据,接口名称上方查看
// 接口请求入参配置
$requestParams = [
    'key' => $apiKey,
    'mobile'=> '18988888888',
];
$requestParamsStr = http_build_query($requestParams);

// 发起接口网络请求
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $apiUrl . '?' . $requestParamsStr);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
if (1 == strpos("$" . $apiUrl, "https://")) {
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
$response = curl_exec($curl);
$httpInfo = curl_getinfo($curl);
curl_close($curl);

// 解析响应结果
$responseResult = json_decode($response, true);
if ($responseResult) {
    // 网络请求成功。可依据业务逻辑和接口文档说明自行处理。
    var_dump($responseResult);
} else {
    // 网络异常等因素，解析结果异常。可依据业务逻辑自行处理。
    // var_dump($httpInfo);
    var_dump("请求异常");
}

import requests

# 966-手机在网时长 - 代码参考（根据实际业务情况修改）

# 基本参数配置
apiUrl = 'http://v.juhe.cn/mobileOnline/query'  # 接口请求URL
apiKey = '您申请的调用APIkey'  # 在个人中心->我的数据,接口名称上方查看

# 接口请求入参配置
requestParams = {
    'key': apiKey,
    'mobile': '18988888888',
}

# 发起接口网络请求
response = requests.get(apiUrl, params=requestParams)

# 解析响应结果
if response.status_code == 200:
    responseResult = response.json()
    # 网络请求成功。可依据业务逻辑和接口文档说明自行处理。
    print(responseResult)
else:
    # 网络异常等因素，解析结果异常。可依据业务逻辑自行处理。
    print('请求异常')

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
)

func main() {
    // 基本参数配置
    apiUrl := "http://v.juhe.cn/mobileOnline/query"
    apiKey := "您申请的调用APIkey"
    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("mobile", "18988888888")

    // 发起接口网络请求
    resp, err := http.Get(apiUrl + "?" + requestParams.Encode())
    if err != nil {
        fmt.Println("网络请求异常:", err)
        return
    }
    defer resp.Body.Close()

    var responseResult map[string]interface{}
    err = json.NewDecoder(resp.Body).Decode(&responseResult)
    if err != nil {
        fmt.Println("解析响应结果异常:", err)
        return
    }
    fmt.Println(responseResult)
}

using System;
using System.Net;
using Newtonsoft.Json;
using System.Collections.Generic;
using System.Linq;

namespace Common_API_Test.Test_Demo
{
    class Csharp_get
    {
        static void Main(string[] args)
        {
            string url = "http://v.juhe.cn/mobileOnline/query";
            string apiKey = "您申请的调用APIkey";

            Dictionary<string, string> data = new Dictionary<string, string>();
            data.Add("key", apiKey);
            data.Add( "mobile", "18988888888");

            using (WebClient client = new WebClient())
            {
                string fullUrl = url + "?" + string.Join("&", data.Select(x => x.Key + "=" + x.Value));

                try
                {
                    string responseContent = client.DownloadString(fullUrl);
                    dynamic responseData = JsonConvert.DeserializeObject(responseContent);

                    if (responseData != null)
                    {
                        Console.WriteLine("Return Code: " + responseData["error_code"]);
                        Console.WriteLine("Return Message: " + responseData["reason"]);
                    }
                    else
                    {
                        Console.WriteLine("json解析异常！");
                    }
                }
                catch (Exception)
                {
                    Console.WriteLine("请检查其它错误");
                }
            }
        }
    }
}

const axios = require('axios'); // npm install axios

// 基本参数配置
const apiUrl = 'http://v.juhe.cn/mobileOnline/query';  // 接口请求URL
const apiKey = '您申请的调用APIkey';  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
const requestParams = {
    key: apiKey,
    mobile: '18988888888',
};

// 发起接口网络请求
axios.get(apiUrl, {params: requestParams})
    .then(response => {
        // 解析响应结果
        if (response.status === 200) {
            const responseResult = response.data;
            // 网络请求成功。可依据业务逻辑和接口文档说明自行处理。
            console.log(responseResult);
        } else {
            // 网络异常等因素，解析结果异常。可依据业务逻辑自行处理。
            console.log('请求异常');
        }
    })
    .catch(error => {
        // 网络请求失败，可以根据实际情况进行处理
        console.log('网络请求失败:', error);
    });

package cn.juhe.test;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.URL;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;
import java.util.stream.Collectors;

public class JavaGet {
    public static void main(String[] args) throws Exception {
        String apiKey = "你申请的key";
        String apiUrl = "http://v.juhe.cn/mobileOnline/query";

        HashMap<String, String> map = new HashMap<>();
        map.put("key", apiKey);
        map.put("mobile", "18988888888");

        URL url = new URL(String.format("%s?%s", apiUrl, params(map)));
        BufferedReader in = new BufferedReader(new InputStreamReader((url.openConnection()).getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        System.out.println(response);
    }

    public static String params(Map<String, String> map) {
        return map.entrySet().stream()
                .map(entry -> {
                    try {
                        return entry.getKey() + "=" + URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8.toString());
                    } catch (Exception e) {
                        e.printStackTrace();
                        return entry.getKey() + "=" + entry.getValue();
                    }
                })
                .collect(Collectors.joining("&"));
    }
}

// 基本参数配置
NSString *apiUrl = @"http://v.juhe.cn/mobileOnline/query";  // 接口请求URL
NSString *apiKey = @"您申请的调用APIkey";  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
NSDictionary *requestParams = @{
    @"key": apiKey,
    @"mobile": @"18988888888",
};

// 发起接口网络请求
NSURLComponents *components = [NSURLComponents componentsWithString:apiUrl];
NSMutableArray *queryItems = [NSMutableArray array];
[requestParams enumerateKeysAndObjectsUsingBlock:^(NSString *key, NSString *value, BOOL *stop) {
    [queryItems addObject:[NSURLQueryItem queryItemWithName:key value:value]];
}];
components.queryItems = queryItems;

NSURL *url = components.URL;
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
    if (error) {
        // 网络请求异常处理
        NSLog(@"请求异常");
    } else {
        NSError *jsonError;
        NSDictionary *responseResult = [NSJSONSerialization JSONObjectWithData:data options:0 error:&jsonError];
        if (!jsonError) {
            // 网络请求成功处理
            // NSLog(@"%@", [responseResult objectForKey:@"error_code"]);
            NSLog(@"%@", responseResult);
        } else {
            // 解析结果异常处理
            NSLog(@"解析结果异常");
        }
    }
}];
[task resume];

返回参数说明：

名称	类型	说明
reason	string	原因
res	int	查询结果，1存在,返回固定1
code	string	在网时长编码(03,04,1,2,3,99)
desc	string	在网时长说明,与在网时长编码一一对应(表示月数):(0,3],(3,6],(6,12],(12,24],(24,+),T-1月前已离网/手机状态异常
province	string	省份
city	string	城市
error_code	int	返回码:0计费，其他不计费,参照错误码参考
isp	string	手机运营商,如:移动

JSON返回示例：JSON在线格式化工具 >

      {
    "reason": "成功",
    "result": {
        "idnum": "",
        "name": "",
        "mobile": "158568696583",
        "res": 1,
        "code": "3",
        "desc": "(24,+)",
        "province": "江苏",
        "city": "苏州",
        "isp": "移动"
    },
    "error_code": 0
}

	名称	必填	类型	说明
	key	是	String	APPKEY值
	mobile	是	String	手机号加密后

服务级错误码参照(error_code)：

	错误码	说明
	224801	查询无此记录
	224804	参数错误
	224805	网络异常，请重试
	224808	查询失败

系统级错误码参照：

错误码	说明	旧版本（resultcode）
10001	错误的请求KEY	101
10002	该KEY无请求权限	102
10003	KEY过期	103
10004	错误的OPENID	104
10005	应用未审核超时，请提交认证	105
10007	未知的请求源	107
10008	被禁止的IP	108
10009	被禁止的KEY	109
10011	当前IP请求超过限制	111
10012	请求超过次数限制	112
10013	测试KEY超过请求限制	113
10014	系统内部异常 (调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失)	114
10020	接口维护	120
10021	接口停用	121

错误码格式说明（示例：200201）：

	2	002	01
	服务级错误（1为系统级错误）	服务模块代码(即数据ID)	具体错误代码

手机在网时长[简]

限企业实名用户使用

本接口需提供应用场景审核

个人（基础认证）实名用户无法使用

API资讯

数据驱动未来

Data Drives The Future

立即注册

找API接口，上云客通信息科技！

手机在网时长[简]

产品功能

接口文档

功能介绍

应用场景

产品参数

使用流程

合作客户

服务保障

推荐API

API资讯