三网手机实名制认证[详]

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

核验手机运营商三要素（手机号码、姓名、身份证号）信息是否一致，返回验证结果和错误原因。

¥79.2

补贴后单价：

申请赠送05次

约¥0/次
一元试用150次

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

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

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

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

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

约¥0.19/次

立即购买

产品功能
接口文档

接口文档

手机实名校验
手机校验验签版
加密传输查询
RSA加密传输查询(OAEP)

错误码

错误码列表

资源下载

接口文档下载

手机实名校验

接口地址：http://apis.juhe.cn/telecom3/query

请求方式：http get/post

返回类型：json

接口描述：根据姓名、身份证、手机号码校验是否一致,并返回不一致详情，支持移动、联通号码

接口调试： API测试工具

请求Header：

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

请求参数说明：

名称	必填	类型	说明
key	是	string	在个人中心->我的数据,接口名称上方查看
realname	是	string	姓名，需要utf8 Urlencode
idcard	是	string	身份证号码
mobile	是	string	手机号码

请求代码示例：

curl
PHP
Python
Go
C#
Node
Java
ObjectC

curl -k -i "http://apis.juhe.cn/telecom3/query?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&mobile=18988888888"

<?php
/**
 * 1189-手机实名校验 - 代码参考（根据实际业务情况修改）
 */
// 基本参数配置
$apiUrl = "http://apis.juhe.cn/telecom3/query"; // 接口请求URL
$method = "GET"; // 接口请求方式
$headers = ["Content-Type: application/x-www-form-urlencoded"]; // 接口请求header
$apiKey = "您申请的调用APIkey"; // 在个人中心->我的数据,接口名称上方查看
// 接口请求入参配置
$requestParams = [
    'key' => $apiKey,
    'realname'=> '李云客',
    'idcard'=> '370121xxxxxxxx1040',
    '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

# 1189-手机实名校验 - 代码参考（根据实际业务情况修改）

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

# 接口请求入参配置
requestParams = {
    'key': apiKey,
    'realname': '李云客',
    'idcard': '370121xxxxxxxx1040',
    '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://apis.juhe.cn/telecom3/query"
    apiKey := "您申请的调用APIkey"
    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("realname", "李云客")
    requestParams.Set("idcard", "370121xxxxxxxx1040")
    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://apis.juhe.cn/telecom3/query";
            string apiKey = "您申请的调用APIkey";

            Dictionary<string, string> data = new Dictionary<string, string>();
            data.Add("key", apiKey);
            data.Add( "realname", "李云客");
            data.Add( "idcard", "370121xxxxxxxx1040");
            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://apis.juhe.cn/telecom3/query';  // 接口请求URL
const apiKey = '您申请的调用APIkey';  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
const requestParams = {
    key: apiKey,
    realname: '李云客',
    idcard: '370121xxxxxxxx1040',
    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://apis.juhe.cn/telecom3/query";

        HashMap<String, String> map = new HashMap<>();
        map.put("key", apiKey);
        map.put("realname", "李云客");
        map.put("idcard", "370121xxxxxxxx1040");
        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://apis.juhe.cn/telecom3/query";  // 接口请求URL
NSString *apiKey = @"您申请的调用APIkey";  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
NSDictionary *requestParams = @{
    @"key": apiKey,
    @"realname": @"李云客",
    @"idcard": @"370121xxxxxxxx1040",
    @"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];

返回参数说明：

名称	类型	说明
error_code	int	状态码
reason	string	状态提示
result	json	返回结果

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

      {
    "error_code": 0/*错误码,返回0时计费一次*/
    "reason": "查询成功",/*原因*/
    "result": {
       "orderid":"J339201812031141197115QV",/*流水号*/
        "res": 2,/*匹配结果：1匹配 2不匹配*/
        "resmsg": "三要素身份验证不一致",/*说明*/
         "type": "移动",/*手机运营商*/
        "province":"广东省",/*归属地省*/
        "city" : "惠州市",/**归属地城市*/
    "rescode":"23",/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,
23:姓名身份证均不匹配*/
    }
}

手机校验验签版

接口地址：http://apis.juhe.cn/telecom3/verify

请求方式：get/post

返回类型：json

接口描述：验签版本

接口调试： API测试工具

请求Header：

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

请求参数说明：

名称	必填	类型	说明
key	是	string	在个人中心->我的数据,接口名称上方查看
realname	是	string	姓名，需要utf8 Urlencode
idcard	是	string	身份证号码
mobile	是	string	手机号码
sign	是	string	md5(openid+appkey+realname+idcard+mobile)后小写,openid在个人中心查询

请求代码示例：

curl
PHP
Python
Go
C#
Node
Java
ObjectC

curl -k -i "http://apis.juhe.cn/telecom3/verify?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&mobile=18988888888&sign=86ce8935xxxxxxxxxxxxxxxx03c3eea0"

<?php
/**
 * 1190-手机校验验签版 - 代码参考（根据实际业务情况修改）
 */
// 基本参数配置
$apiUrl = "http://apis.juhe.cn/telecom3/verify"; // 接口请求URL
$method = "GET"; // 接口请求方式
$headers = ["Content-Type: application/x-www-form-urlencoded"]; // 接口请求header
$apiKey = "您申请的调用APIkey"; // 在个人中心->我的数据,接口名称上方查看
// 接口请求入参配置
$requestParams = [
    'key' => $apiKey,
    'realname'=> '李云客',
    'idcard'=> '370121xxxxxxxx1040',
    'mobile'=> '18988888888',
    'sign'=> '86ce8935xxxxxxxxxxxxxxxx03c3eea0',
];
$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

# 1190-手机校验验签版 - 代码参考（根据实际业务情况修改）

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

# 接口请求入参配置
requestParams = {
    'key': apiKey,
    'realname': '李云客',
    'idcard': '370121xxxxxxxx1040',
    'mobile': '18988888888',
    'sign': '86ce8935xxxxxxxxxxxxxxxx03c3eea0',
}

# 发起接口网络请求
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://apis.juhe.cn/telecom3/verify"
    apiKey := "您申请的调用APIkey"
    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("realname", "李云客")
    requestParams.Set("idcard", "370121xxxxxxxx1040")
    requestParams.Set("mobile", "18988888888")
    requestParams.Set("sign", "86ce8935xxxxxxxxxxxxxxxx03c3eea0")

    // 发起接口网络请求
    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://apis.juhe.cn/telecom3/verify";
            string apiKey = "您申请的调用APIkey";

            Dictionary<string, string> data = new Dictionary<string, string>();
            data.Add("key", apiKey);
            data.Add( "realname", "李云客");
            data.Add( "idcard", "370121xxxxxxxx1040");
            data.Add( "mobile", "18988888888");
            data.Add( "sign", "86ce8935xxxxxxxxxxxxxxxx03c3eea0");

            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://apis.juhe.cn/telecom3/verify';  // 接口请求URL
const apiKey = '您申请的调用APIkey';  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
const requestParams = {
    key: apiKey,
    realname: '李云客',
    idcard: '370121xxxxxxxx1040',
    mobile: '18988888888',
    sign: '86ce8935xxxxxxxxxxxxxxxx03c3eea0',
};

// 发起接口网络请求
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://apis.juhe.cn/telecom3/verify";

        HashMap<String, String> map = new HashMap<>();
        map.put("key", apiKey);
        map.put("realname", "李云客");
        map.put("idcard", "370121xxxxxxxx1040");
        map.put("mobile", "18988888888");
        map.put("sign", "86ce8935xxxxxxxxxxxxxxxx03c3eea0");

        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://apis.juhe.cn/telecom3/verify";  // 接口请求URL
NSString *apiKey = @"您申请的调用APIkey";  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
NSDictionary *requestParams = @{
    @"key": apiKey,
    @"realname": @"李云客",
    @"idcard": @"370121xxxxxxxx1040",
    @"mobile": @"18988888888",
    @"sign": @"86ce8935xxxxxxxxxxxxxxxx03c3eea0",
};

// 发起接口网络请求
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];

返回参数说明：

名称	类型	说明
error_code	int	状态码
reason	string	状态提示
result	json	返回结果

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

      {
    "error_code": 0/*错误码,返回0时计费一次*/
    "reason": "查询成功",/*原因*/
    "result": {
       "orderid":"J339201812031141197115QV",/*流水号*/
        "res": 2,/*匹配结果：1匹配 2不匹配*/
        "resmsg": "三要素身份验证不一致",/*匹配说明*/
         "type": "移动",/*手机运营商*/
         "province":"广东省",/*归属地省*/
        "city" : "惠州市",/**归属地城市*/
        "rescode":"24"/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,
23:姓名身份证均不匹配*/
    }
}

加密传输查询

接口地址：http://apis.juhe.cn/telecom3/queryEncry

请求方式：get/post

返回类型：json

接口描述：根据姓名、身份证、手机号码校验是否一致

接口调试： API测试工具

请求Header：

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

请求参数说明：

名称	必填	类型	说明
key	是	string	在个人中心->我的数据,接口名称上方查看
realname	是	string	姓名经过加密后
idcard	是	string	身份证号码经过加密后
mobile	是	string	手机号码经过加密后

请求代码示例：

curl
PHP
Python
Go
C#
Node
Java
ObjectC

curl -k -i "http://apis.juhe.cn/telecom3/queryEncry?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=IQlzINs505xxxxxxxxxxAt%2BaIfegniu4uKU0xo68w&mobile=IQlzINs505xxxxxxxxxxAt%2BaIfegniu4uKU0xo68w"

<?php
/**
 * 1191-加密传输查询 - 代码参考（根据实际业务情况修改）
 */
// 基本参数配置
$apiUrl = "http://apis.juhe.cn/telecom3/queryEncry"; // 接口请求URL
$method = "GET"; // 接口请求方式
$headers = ["Content-Type: application/x-www-form-urlencoded"]; // 接口请求header
$apiKey = "您申请的调用APIkey"; // 在个人中心->我的数据,接口名称上方查看
// 接口请求入参配置
$requestParams = [
    'key' => $apiKey,
    'realname'=> '李云客',
    'idcard'=> 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
    'mobile'=> 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
];
$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

# 1191-加密传输查询 - 代码参考（根据实际业务情况修改）

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

# 接口请求入参配置
requestParams = {
    'key': apiKey,
    'realname': '李云客',
    'idcard': 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
    'mobile': 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
}

# 发起接口网络请求
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://apis.juhe.cn/telecom3/queryEncry"
    apiKey := "您申请的调用APIkey"
    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("realname", "李云客")
    requestParams.Set("idcard", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w")
    requestParams.Set("mobile", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w")

    // 发起接口网络请求
    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://apis.juhe.cn/telecom3/queryEncry";
            string apiKey = "您申请的调用APIkey";

            Dictionary<string, string> data = new Dictionary<string, string>();
            data.Add("key", apiKey);
            data.Add( "realname", "李云客");
            data.Add( "idcard", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w");
            data.Add( "mobile", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w");

            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://apis.juhe.cn/telecom3/queryEncry';  // 接口请求URL
const apiKey = '您申请的调用APIkey';  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
const requestParams = {
    key: apiKey,
    realname: '李云客',
    idcard: 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
    mobile: 'IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w',
};

// 发起接口网络请求
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://apis.juhe.cn/telecom3/queryEncry";

        HashMap<String, String> map = new HashMap<>();
        map.put("key", apiKey);
        map.put("realname", "李云客");
        map.put("idcard", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w");
        map.put("mobile", "IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w");

        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://apis.juhe.cn/telecom3/queryEncry";  // 接口请求URL
NSString *apiKey = @"您申请的调用APIkey";  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
NSDictionary *requestParams = @{
    @"key": apiKey,
    @"realname": @"李云客",
    @"idcard": @"IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w",
    @"mobile": @"IQlzINs505xxxxxxxxxxAt+aIfegniu4uKU0xo68w",
};

// 发起接口网络请求
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];

返回参数说明：

名称	类型	说明
error_code	int	状态码
reason	string	状态提示
result	json	返回结果
result.res	int	匹配结果,1匹配,2不匹配
result.resmg	string	返回匹配描述
result.type	stirng	手机运营商
result.province	string	省份
result.city	string	城市
result.rescode	string	返回详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,23:姓名身份证均不匹配,24:不匹配,具体要素不匹配未知

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

       
加密算法：AES/ECB/PKCS5Padding，AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的KEY为:客户个人中心的openid经过md5后结果为小写取前16位

{
    "error_code": 0/*错误码,返回0时计费一次*/
    "reason": "查询成功",/*原因*/
    "result": {
       "orderid":"J339201812031141197115QV",/*流水号*/
        "res": 2,/*匹配结果：1匹配 2不匹配*/
        "resmsg": "三要素身份验证不一致",/*匹配说明*/
         "type": "移动",/*手机运营商*/
         "province":"广东省",/*归属地省*/
        "city" : "惠州市",/**归属地城市*/
        "rescode":"24"/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,
23:姓名身份证均不匹配*/
    }
}

RSA加密传输查询(OAEP)

接口地址：http://apis.juhe.cn/telecom3/queryRV2

请求方式：get/post

返回类型：json

接口描述：根据姓名、身份证、手机号码校验是否一致

接口调试： API测试工具

请求Header：

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

请求参数说明：

名称	必填	类型	说明
key	是	string	在个人中心->我的数据,接口名称上方查看
realname	是	string	姓名经过加密后RSA(RSA/ECB/OAEPWithSHA-1AndMGF1Padding)
idcard	是	string	身份证号码经过加密后RSA(RSA/ECB/OAEPWithSHA-1AndMGF1Padding)
mobile	是	string	手机号码经过加密后RSA(RSA/ECB/OAEPWithSHA-1AndMGF1Padding)

请求代码示例：

curl
PHP
Python
Go
C#
Node
Java
ObjectC

curl -k -i "http://apis.juhe.cn/telecom3/queryRV2?key=key&realname=%E6%9D%8E%E8%81%9A%E5%90%88&idcard=370121xxxxxxxx1040&mobile=18988888888"

<?php
/**
 * 1898-RSA加密传输查询(OAEP) - 代码参考（根据实际业务情况修改）
 */
// 基本参数配置
$apiUrl = "http://apis.juhe.cn/telecom3/queryRV2"; // 接口请求URL
$method = "GET"; // 接口请求方式
$headers = ["Content-Type: application/x-www-form-urlencoded"]; // 接口请求header
$apiKey = "您申请的调用APIkey"; // 在个人中心->我的数据,接口名称上方查看
// 接口请求入参配置
$requestParams = [
    'key' => $apiKey,
    'realname'=> '李云客',
    'idcard'=> '370121xxxxxxxx1040',
    '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

# 1898-RSA加密传输查询(OAEP) - 代码参考（根据实际业务情况修改）

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

# 接口请求入参配置
requestParams = {
    'key': apiKey,
    'realname': '李云客',
    'idcard': '370121xxxxxxxx1040',
    '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://apis.juhe.cn/telecom3/queryRV2"
    apiKey := "您申请的调用APIkey"
    // 接口请求入参配置
    requestParams := url.Values{}
    requestParams.Set("key", apiKey)
    requestParams.Set("realname", "李云客")
    requestParams.Set("idcard", "370121xxxxxxxx1040")
    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://apis.juhe.cn/telecom3/queryRV2";
            string apiKey = "您申请的调用APIkey";

            Dictionary<string, string> data = new Dictionary<string, string>();
            data.Add("key", apiKey);
            data.Add( "realname", "李云客");
            data.Add( "idcard", "370121xxxxxxxx1040");
            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://apis.juhe.cn/telecom3/queryRV2';  // 接口请求URL
const apiKey = '您申请的调用APIkey';  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
const requestParams = {
    key: apiKey,
    realname: '李云客',
    idcard: '370121xxxxxxxx1040',
    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://apis.juhe.cn/telecom3/queryRV2";

        HashMap<String, String> map = new HashMap<>();
        map.put("key", apiKey);
        map.put("realname", "李云客");
        map.put("idcard", "370121xxxxxxxx1040");
        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://apis.juhe.cn/telecom3/queryRV2";  // 接口请求URL
NSString *apiKey = @"您申请的调用APIkey";  // 在个人中心->我的数据,接口名称上方查看

// 接口请求入参配置
NSDictionary *requestParams = @{
    @"key": apiKey,
    @"realname": @"李云客",
    @"idcard": @"370121xxxxxxxx1040",
    @"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];

返回参数说明：

名称	类型	说明
error_code	int	状态码
reason	string	状态提示
result	json	返回结果
result.res	int	匹配结果,1匹配,2不匹配
result.resmg	string	返回匹配描述
result.type	stirng	手机运营商
result.province	string	省份
result.city	string	城市
result.rescode	string	返回详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,23:姓名身份证均不匹配,24:不匹配,具体要素不匹配未知

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

      {
    "error_code": 0/*错误码,返回0时计费一次*/
    "reason": "查询成功",/*原因*/
    "result": {
       "orderid":"J339201812031141197115QV",/*流水号*/
        "res": 2,/*匹配结果：1匹配 2不匹配*/
        "resmsg": "三要素身份验证不一致",/*匹配说明*/
         "type": "移动",/*手机运营商*/
         "province":"广东省",/*归属地省*/
        "city" : "惠州市",/**归属地城市*/
        "rescode":"24"/*匹配详情码,11:匹配,21:姓名不匹配,22:身份证不匹配,
23:姓名身份证均不匹配*/
    }
}

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

	错误码	说明
	233901	服务商网络异常，请重试
	233902	查询失败，具体参照reason
	233903	库中无此记录
	233907	参数错误，具体请看reason

系统级错误码参照：

错误码	说明	旧版本（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资讯