手机在网时长查询接口
更新时间：2024-10-19
1.功能说明
1.1.用于查询手机号码的在网时长；
1.2.多用于精准营销、风控审核等场景；
1.3.接口发送调用地址：http(s)://api.guoyangyun.com/api/verify/operatorDuration.htm
1.4.请求方式：以HTTP POST请求的方式（推荐使用post方式）；
1.5.汉字字符集：UTF-8，请注意参数的大小写。
1.2.多用于精准营销、风控审核等场景；
1.3.接口发送调用地址：http(s)://api.guoyangyun.com/api/verify/operatorDuration.htm
1.4.请求方式：以HTTP POST请求的方式（推荐使用post方式）；
1.5.汉字字符集：UTF-8，请注意参数的大小写。
2.输入参数
| 参数 | 名称 | 类型 | 必须 | 描述 |
| 公共参数 | 公共参数 | — | 是 | 详见《公共参数和配置》文档 |
| mobile | 手机号码 | String | 是 | 手机号码 |
3.调用示例
http(s)://api.guoyangyun.com/api/verify/operatorDuration.htm?appkey=xxxxxxx&appsecret=xxxxxxx&mobile=xxxxxxx
4.Json返回
4.1.返回参数
| 参数 | 名称 | 类型 | 描述 |
| code | 返回码 | String | 提交返回结果。0：表示成功，其他：失败。（状态码详见：《公共错误代码定义》） |
| msg | 信息描述 | String | 返回码对应的中文描述。 |
 data |
查询信息 | List | 查询结果详情 |
| responseCode | 结果编码 | String | 时长编码 |
| responseDesc | 结果描述 | String | 核验结果描述{0-3个月，3-6个月，6-12个月，12-24个月，24个月及以上} |
| traceNo | 流水号 | String | 商户流水号 |
4.2.调用成功样例
{
"code": "0",
"msg": "成功",
"data": {
"responseCode": "4", //时长编码
"responseDesc": "24个月及以上", //结果描述
"traceNo": "4ae61baafa364e" //商户流水号
}
}
4.3.调用失败样例
{
"code":"XXXX",
"msg":"错误提示内容"
}