携号转网查询接口API,手机号码归属地及运营商查询接口

携号转网查询接口API,手机号码归属地及运营商查询接口携号转网的基本概念:携号转网,也称作号码携带、移机不改号,也就是说一家电信运营商的用户,无需改变自己的手机号码,就能转而成为另一家电信运营商的用户,并享受其提供的各种服务

携号转网实时手机号归属地及运营商查询接口API

可以使用以下http地址免费测试(请求号码需更换):

https://gw.qxt800.com/qxt_test?mobile=13972565391


携号转网的基本概念: 

携号转网,也称作号码携带、移机不改号,也就是说一家电信运营商的用户,无需改变自己的手机号码,就能转而成为另一家电信运营商的用户,并享受其提供的各种服务。

携号转网的应用及对第三方运营商的痛点:

基于用户携号转网后,第三方运营者原有数据标签未及时更新,导致业务操作上的失败,如短信接收失败,号码充值失败等多个应用场景。据不完全统计目前携号转网用户约占全网用户的1%,携号转网的查询应用于互联网金融、担保、法律、旅游、保险、电商、人力资源、租赁等各类有需求的政府、企业等机构以及风控审核和信用评定环节。

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzU5MDk2MTQ0,size_16,color_FFFFFF,t_70

 

企讯通携号转网接口:

企讯通携号转网接口对外开放http接口方式,系统直连于三大运营商实时返回查询结果,非缓存库,非本地数据库数据返回,准确率99.99%,用户通过手机号的传入即可查询该号码是否携号转网,返回结果具体有实时性、准确性等特点。

企讯通携号转网接口响应速度快,响应时间基本在10毫秒左右返回。
以下为压力测试时的数据日志:

20210611221449376.png          

接口编码方式采用统一的UTF-8,请求方式采用HTTP REST,支持GET/POST方式。
提供http和https调用类型。
请求地址如下:
  ——————————————————————————

标准http 协议url地址: http://isp.qxt800.com/

标准https协议url地址: https://isp.qxt800.com/

——————————————————————————

java-请求示例:

public static void main(String[] args) {
	    String host = "https://xhzw.market.alicloudapi.com";
	    String path = "/isp";
	    String method = "POST";
	    String appcode = "你自己的AppCode";
	    Map<String, String> headers = new HashMap<String, String>();
	    //最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
	    headers.put("Authorization", "APPCODE " + appcode);
	    Map<String, String> querys = new HashMap<String, String>();
	    querys.put("mobile", "mobile");
	    String bodys = "";


	    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();
	    }
	}

C#-请求示例:

//using System.IO;
//using System.Text;
//using System.Net;
//using System.Net.Security;
//using System.Security.Cryptography.X509Certificates;

        private const String host = "https://xhzw.market.alicloudapi.com";
        private const String path = "/isp";
        private const String method = "POST";
        private const String appcode = "你自己的AppCode";

        static void Main(string[] args)
        {
            String querys = "mobile=mobile";
            String bodys = "";
            String url = host + path;
            HttpWebRequest httpRequest = null;
            HttpWebResponse httpResponse = null;

            if (0 < querys.Length)
            {
                url = url + "?" + querys;
            }

            if (host.Contains("https://"))
            {
                ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
                httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url));
            }
            else
            {
                httpRequest = (HttpWebRequest)WebRequest.Create(url);
            }
            httpRequest.Method = method;
            httpRequest.Headers.Add("Authorization", "APPCODE " + appcode);
            if (0 < bodys.Length)
            {
                byte[] data = Encoding.UTF8.GetBytes(bodys);
                using (Stream stream = httpRequest.GetRequestStream())
                {
                    stream.Write(data, 0, data.Length);
                }
            }
            try
            {
                httpResponse = (HttpWebResponse)httpRequest.GetResponse();
            }
            catch (WebException ex)
            {
                httpResponse = (HttpWebResponse)ex.Response;
            }

            Console.WriteLine(httpResponse.StatusCode);
            Console.WriteLine(httpResponse.Method);
            Console.WriteLine(httpResponse.Headers);
            Stream st = httpResponse.GetResponseStream();
            StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
            Console.WriteLine(reader.ReadToEnd());
            Console.WriteLine("\n");

        }

        public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
        {
            return true;
        }

PHP-请求示例:

<php
    $host = "https://xhzw.market.alicloudapi.com";
    $path = "/isp";
    $method = "POST";
    $appcode = "你自己的AppCode";
    $headers = array();
    array_push($headers, "Authorization:APPCODE " . $appcode);
    $querys = "mobile=mobile";
    $bodys = "";
    $url = $host . $path . "?" . $querys;

    $curl = curl_init();
    curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_FAILONERROR, false);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HEADER, true);
    if (1 == strpos("$".$host, "https://"))
    {
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    }
    var_dump(curl_exec($curl));
>

Python-请求示例:

import urllib, urllib2, sys
import ssl


host = 'https://xhzw.market.alicloudapi.com'
path = '/isp'
method = 'POST'
appcode = '你自己的AppCode'
querys = 'mobile=mobile'
bodys = {}
url = host + path + '?' + querys

request = urllib2.Request(url)
request.add_header('Authorization', 'APPCODE ' + appcode)
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
response = urllib2.urlopen(request, context=ctx)
content = response.read()
if (content):
    print(content)

 

正常返回示例:

{
     code:  0,                        //code 返回0表示本次查询成功
     reason: "Succ",                  //reason 返回详细的请求状态说明码
     result: {
         res: "1",                    //res 是否转网,0,未转网,1,已转网(明确已转网),如返回3或4则为虚拟运营商
         Mobile: "13972565391",       //查询的手机号码
         Area: "广东-深圳",           //号码归属地,格式为:省-市
         Init_isp: "移动",            //最初归属的运营商
         Now_isp: "电信"              //转网后的运营商,如果未转网,则同Init_isp一致
         }
}

 

失败返回示例:

{
    code: "-8",                       //code 返回非0的数字表示api查询失败,具体的原因见错误码配置
    reason: "系统错误,或稍候再试"     //reason 返回详细的请求状态说明码  
}

 

提供接口的同时也向用户开放web管理查询界面,请与管理员索取。


1、携号转网查询接口

用户的客户端向企讯通携号转网接口提交需要查询的号码

 

1.1-请求地址

地址1:  http://isp.qxt800.com/carrier

地址2:  https://isp.qxt800.com/carrier

请求方式可以 POST 和 GET方式,建议采用POST方式,默认返回为JSON格式

 

1.2-参数说明

参数名称

类型

是否必传

说明

示例

apikey

string

用户唯一标识,帐户信息

7c11272au708345c834b8ue81ac78972

mobile

string

需要查询的号码

13972565391

例如:

http://isp.qxt800.com/carrier?apikey=7c11272au708345c834b8ue81ac78972send&mobile=13972565391

                     

1.3-响应数据

{
    "code": 0,
    "reason": "Succ",
    "result": 
        {
            "res": "1",
            "Mobile": "13972565391",
            "Area": "湖北-宜昌",
            "Init_isp": "移动",
            "Now_isp": "电信"
    

以下是在浏览器测试返回的数据:

20210611222847180.png

字段

说明

code

请求结果,0,其它为错误,具体见文档尾处的code错误代码表

reason

对应code的返回说明,如Succ表示请求成功

result

包含多项值,如下表格

res

res 是否转网,0,未转网,1,已转网(明确已转网),如返回3或4则为虚拟运营商

Mobile

查询的手机号码

Area

号码归属地,格式为:省-市

Init_isp

最初归属的运营商

Now_isp

转网后的运营商,如果未转网,则同Init_isp一致

 

2、余额查询接口

用于客户端查询当前账户余额,此接口可查询输出当前可以请求的次数。

 

2.1-请求地址

地址1:  http://isp.qxt800.com/balance

地址2:  https://isp.qxt800.com/balance

请求方式可以 POST 和 GET方式,建议采用POST方式,默认返回为JSON格式

 

2.2-参数说明

参数名称

类型

是否必传

说明

示例

apikey

string

用户唯一标识,帐户信息

7c11272au708345c834b8ue81ac78972

例如:

http://isp.qxt800.com/balance?apikey=7c11272au708345c834b8ue81ac78972

 

2.3-响应数据

{

    "code": 0,

    "reason": "Succ",

    "result":

        {

            "feeType": "预付费",

            "balance": "12048",    

        }

}

以下是在浏览器测试返回的数据:

2021061122364694.png

字段

说明

code

请求结果,0,其它为错误,具体见文档尾处的code错误代码表

reason

对应code的返回说明,如Succ表示请求成功

result

包含多项值,如下

feeType

结算方式,根据用户情况输出 预付费、后付费 两个值

balance

当前余额(可查询的次数),后付费可能为负数

3. Code错误代码表

错误代码

具体含义

0

请求成功

1

请求参数缺失,apikey长度不对,查询的手机号码长度不对,查询的手机号码有误

-1

apikey信息不匹配(用户信息不正确)apikey不正确

-2

查询的手机号码长度不对

-3

请填写正确的手机号码

-4

未查询到相关信息或填写正确的手机号码再查询

-5

当前余额不足发起本次查询请求,请与供应商联系

-8

系统错误,请稍候再试

-9

ip地址鉴权失败

 

 

今天的文章携号转网查询接口API,手机号码归属地及运营商查询接口分享到此就结束了,感谢您的阅读。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/64537.html

(0)
编程小号编程小号

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注