在金融风控、实名认证、电商注册与用户画像等场景中，手机号的"在网时长"是判断用户稳定性和真实性的重要指标。
为了帮助企业和开发者快速完成集成，笔者新诺韦尔API将从接口申请、签名算法、调用流程、返回解析到异常排查，全面讲解手机在网时长查询接口的对接全流程。
一、什么是手机在网时长接口？
手机在网时长查询接口是基于手机号运营商数据的查询服务。通过输入手机号，系统可实时返回号码在运营商数据库中的在网时长区间（单位：月），例如：
返回区间[0,3)代表新注册号码，风险较高；[6,12)代表使用半年至一年，稳定性较好；[24,-1)意味着超过两年，为长期真实用户。
该数据可用于：
风控模型：识别短期注册号码，降低欺诈风险；
实名验证：验证手机号使用年限，辅助判断真实性；
电商注册：阻止批量注册和异常账号；
会员营销：区分长期与短期用户，优化分层策略。
二、手机在网时长接口接入的准备工作
在开始调用前，请确认以下条件已满足：
申请接入信息
向接口服务商申请并获得appId（应用标识）与appKey（加密密钥）。
白名单配置
调用方服务器出口IP必须添加到接口服务方白名单，否则请求将被拦截。
权限与额度
确认"在网时长查询"接口权限已开通且账户余额充足。
三、手机在网时长接口调用的信息
请求头参数说明
请求头（Header）中需携带三个核心参数：
appId：厂商分配的应用标识，用于唯一识别调用方身份；
timestamp：当前时间的Unix时间戳，精确到毫秒（13位）；
sign：签名字符串，用于校验请求合法性，生成规则见下文"签名算法详解"。
这三个字段共同构成接口访问凭证，任何一项缺失或错误都会导致调用失败。
请求体参数说明
请求体（Body）中仅需传递一个核心参数------mobile。
该字段为待查询的中国大陆11位手机号，系统会根据此号码查询其在网时长区间并返回结果。
若号码格式不正确或为空，接口将返回参数错误提示。
四、手机号在网时长接口签名算法详解
签名用于接口安全验证，只有生成正确签名的请求才能被服务端接受。
签名算法公式：sign=sha256(appId+timestamp+appKey)
示例：
appId=qwertyu
timestamp=1682476912345
appKey=asdfghj
sign=sha256("qwertyu1682476912345asdfghj")
注意事项
拼接顺序必须是appId→timestamp→appKey；
时间戳需为毫秒（13位整数），建议与服务端时间差不超过60秒；
生成的sign需为小写十六进制字符串；
appKey为敏感信息，应保存在后端安全配置中，禁止前端调用。
Python签名示例
五、手机在网时长查询接口完整调用流程
以下示例展示从生成签名到请求接口的完整过程：
调用建议：
使用 POST 方式传参以防参数泄露；
每次调用生成新 timestamp 避免签名过期；
在系统日志中记录 orderNo 与 返回内容，便于后续追踪；
批量查询时应设置并发控制与限流策略。
六、手机在网时长接口返回结果解析
接口成功响应示例：
字段说明：
返回数据中的code表示接口状态码，0为成功；message为说明信息；
isCharge表示是否计费（1=计费，0=不计费）；
orderNo为调用流水号，用于账单核对与问题追踪；
data.channel表示运营商类型（cmcc=移动、cucc=联通、ctcc=电信）；
data.time表示在网时长区间（单位为月），例如[6,12)表示使用时间在6到12个月之间。
小结：
手机在网时长接口可帮助企业高效判断手机号使用年限与活跃度，为实名验证、风控建模和营销分析提供可靠依据。
只需正确生成签名、配置白名单、解析返回数据，即可实现从接入到落地的完整闭环。
在实际应用中，可将本接口与身份证核验接口、手机三要素等接口组合使用，构建更完善的身份验证体系。