文档中心

为您提供清晰、准确、易于理解的API文档,帮助开发人员快速上手、理解和使用产品。

调用次数:114 次

【三要素】实名信息验证

正常 需实名认证 按量计费次数包

实名信息验证功能,可以帮助商家在应用内验证采集到的用户信息与实名认证信息是否匹配,可验证的内容包括:姓名(必选)、证件号(必选)、手机号(可选)。 开发者可以利用以上信息,确认用户的真实身份,提供丰富多彩的产品能力。

更新日期
2025-03-08
调用权限
需实名认证
每日限制
无限制
请求频率限制
1秒9999999次
参考价格
0.06元/次

计费控制优先级(按已开通的类型进行):

专业版会员->单独包月->次数包->点数计费->账户余额->免费额度

账户余额:

支持账户余额抵扣,每次扣除金额:0.0500 元/次

次数包:

额度 价格 有效期
1 (次) ¥ 0.06 低至0.06/次 150天
10 (次) ¥ 0.5 低至0.05/次 一年
50 (次) ¥ 3 低至0.06/次 一年
100 (次) ¥ 6 低至0.06/次 一年
5000 (次) ¥ 150 低至0.03/次 一年
10000 (次) ¥ 300 低至0.03/次 一年

请求限制:

免费/测试用户请求频率限制 请求频率总限制 每日请求次数总限制
1000秒1000次 每个免费用户的QPS总限制 1秒9999999次 每个用户QPS总限制 不限 每个用户每日请求总次数

其他准入要求:

  • 账户需要实名认证前往认证
  • 账户余额/点数计费的用户,不限制每日请求次数和QPS
  • 次数包计费的用户,不限制每日请求次数和QPS
  • 接口地址:https://tji0.com/api/auth/verify

    返回格式:application/json

    请求方式:HTTPGETPOST/JSON

    请求示例:见以下文档↓

    请求HEADER:

    名称
    Content-Type application/x-www-form-urlencoded;charset:utf-8;

    请求参数说明:

    名称 必填 类型 示例值 说明
    key string 35kj5jnlj53453kl5j43nj5 用户请求密钥,在控制台->密钥管理查看
    auth_type string preconsult 请求类型。见下表详细说明
    name
    当 auth_type=preconsult 时必填 string 张三 姓名
    idcard 当 auth_type=preconsult 时必填 string 230100199901010001 证件号
    mobile 当 auth_type=preconsult 时可选 string 13812345678 手机号,可选。
    verify_id 当 auth_type=query 时必填 string 139649be03617cda26a6fd7238b98459 唯一验证ID,用于区分用户和查询验证结果,有效期为1小时。

    auth_type 可选参数值说明

    说明
    preconsult 预先录入某用户的实名证件信息(例如姓名、身份证号等),获取验证verify_url(用户访问或扫码验证)和verify_id(本次唯一验证ID,用于区分用户和查询验证结果。)

    query

    通过verify_id查询验证结果,verify_id可通过上面的preconsult获取。

    接入指南:

    第一步:录入用户实名信息

    开发者可调用 auth_type=preconsult 录入用户实名信息,接口将生成 verify_id 用于后续校验。注意 verify_id 有效期为1小时。

    调用示例:

    请求地址?auth_type=preconsult&name=张三&idcard=230100199901010001&mobile=13812345678

    返回示例:

    {"code":200,"msg":"申请验证ID成功...","data":{"verify_url":"数据较多此处省略","verify_qrcode_base64":"data:image/png;base64....数据较多此处省略","verify_id":"139649be03617cda26a6fd7238b98459"},"exec_time":0.059022,"ip":"117.169.192.78"}

    返回参数说明:

    名称 类型 说明
    code int 状态码
    msg string 状态信息
    data string 请求结果数据集
    data.verify_url string 用户访问此URL(支持PC/移动端),跳转到支付宝进行授权验证,建议生成二维码给用户扫描。
    data.verify_qrcode_base64 string verify_url的二维码base64字符串,可直接放在html的img标签的src中显示。然后给用户扫描即可。
    data.verify_id string 本次唯一验证ID,用于区分用户和查询验证结果。
    debug string/array 调试数据
    exec_time float 执行耗时
    user_ip string 请求客户端IP

    第二步:查询验证结果

    开发者可调用 auth_type=query 用第一步生成的 verify_id 进行校验是否验证成功。

    调用示例:

    请求地址?auth_type=query&verify_id=139649be03617cda26a6fd7238b98459

    返回示例【验证成功】:

    {"code":200,"msg":"认证成功!","data":{"verify_id":"7ef49ab3d53b755b64077ea3fc367322","passed":"T","fail_reason":null,"fail_params":null},"exec_time":0.030172,"}

    返回示例【验证失败】:

    {"code":300,"msg":"认证失败:手机号不一致","data":{"verify_id":"139649be03617cda26a6fd7238b98459","passed":"F","fail_reason":"手机号不一致","fail_params":"["mobile"]"},"exec_time":0.030466,"}

    返回参数说明:

    code int 状态码  200:校验一致,300:校验不一致,400:用户未扫描二维码或打开支付宝认证,404:verify_id校验信息不存在或已过期
    msg string 状态信息
    data string 请求结果数据集
    data.passed string 校验验证结果是否一致:T 一致、F 不一致
    data.fail_reason string 校验不一致时,描述不一致的原因
    data.fail_params string 具体哪些字段不一致。与“录入用户实名信息”字段对应,类型为字符串列表的JSON格式。
    data.verify_id string 本次唯一验证ID,用于区分用户和查询验证结果。
    debug string/array 调试数据
    exec_time float 执行耗时
    user_ip string 请求客户端IP


    返回示例:

    {"code":300,"msg":"认证失败:手机号不一致","data":{"verify_id":"139649be03617cda26a6fd7238b98459","passed":"F","fail_reason":"手机号不一致","fail_params":"mobile"},"exec_time":0.030466"}
    错误码类型说明
    403int没有权限
    400int参数传递不正确
    500int服务器内部错误
    
    <?php
    /**
     * API请求DEMO
     * 
     * 本demo支持GET与POST请求,同时支持签名验证与无需签名。
     */
    
    //你申请的key密钥
    $API_KEY = '你的接口密钥,登录控制台后在密钥管理页面申请';
    
    //API接口地址
    $API_URL = 'https://tji0.com/api/auth/verify';
    
    $get_post_data = array(
        //接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
        'key' => $API_KEY,
    	'参数名' => '参数值',
    );
    
    //签名校验的 SK:(在用户控制台https://tji0.com/user/key的秘钥安全设置->签名校验 开启后才会生效,没开启签名校验留空即可。)
    $sk = '56777ab62ff752fbd57ab7228fc2fc43';
    
    /*发起请求API接口:
    第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
    第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
    第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
    第4个参数:是否验证签名,true验证签名,否则false不验证签名,根据用户控制台 https://tji0.com/user/key 的 秘钥安全设置->签名校验 开启后才会生效,如没开启,填写false即可。
    第5个参数:如果第4个参数开启验证签名,此处必须填写 SK ,跟上面的同名变量相对应,无需更改。
     */
    $resdata = api::send($API_URL, $get_post_data, 'GET', true, $sk);  //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
    
    //打印请求结果
    print($resdata);
    ///////////////你的业务代码可写在这里处理API返回的数据
    
    /**
     * API请求类
     */
    class api
    {
        public static function send($API_URL, $get_post_data, $type, $ifsign, $sk)
        {
            $get_post_data = http_build_query($get_post_data);
            if ($ifsign) {
                $sign = md5($get_post_data . $sk);
                $res = self::send_curl($API_URL, $type, $get_post_data, $sign);
            } else {
                $res = self::send_curl($API_URL, $type, $get_post_data, null);
            }
            return $res;
        }
        //封装好的CURL请求函数,支持POST|GET
        public static function send_curl($API_URL, $type, $get_post_data, $sign)
        {
            $ch = curl_init();
            if ($type == 'POST') {
                curl_setopt($ch, CURLOPT_URL, $API_URL);
                curl_setopt($ch, CURLOPT_POST, true);
                curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
            } elseif ($type == 'GET') {
                curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
            }
            if ($sign) {
                curl_setopt($ch, CURLOPT_HTTPHEADER, ['sign:' . $sign]);
            }
            curl_setopt($ch, CURLOPT_REFERER, $API_URL);
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            curl_setopt($ch, CURLOPT_TIMEOUT, 10);
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
            curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
            $resdata = curl_exec($ch);
            curl_close($ch);
            return $resdata;
        }
    }
    
    
    
    
    
    
    //jQuery-Ajax
    $.ajax({
    	url: 'https://tji0.com/api/auth/verify',
    	data: {
    	//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
    		key: '你的接口密钥,登录控制台后在密钥管理页面申请',
    		参数名: '参数值',
    
    	},
    	type: 'GET', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
    	dataType: 'json',
    	success: function(data) {
    		console.log(data); //请求成功,输出结果到控制台
    	},
    	timeout: 3000, //超时时间
    	error: function(data) {
    		console.log('请求失败'); //失败处理
    	}
    });
    
    
    
        
    子程序名 返回值类型 公开 备 注
    __启动窗口_创建完毕    
    ' 添加并使用《精易模块》
    Send_API ()
    子程序名 返回值类型 公开 备 注
    Send_API    
    变量名 类 型 静态 数组 备 注
    REQU_Data 文本型   提交字符串
    return 文本型   返回字符串
    API_URL 文本型   接口地址
    API_KEY 文本型   接口密钥
    API_URL = “https://tji0.com/api/auth/verify”
    API_KEY = “你的接口密钥,登录控制台后在密钥管理页面申请”
    REQU_Data = "请求参数,根据接口文档的请求参数来拼接字符串(例a=a&b=b&c=c)"
    return = 编码_Utf8到Ansi (网页_访问 (API_URL + “?key=” + API_KEY + REQU_Data, , , , , “User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36”))
    输出调试文本 (return)
    
    import java.io.BufferedReader; 
    import java.io.InputStreamReader; 
    import java.net.HttpURLConnection; 
    import java.net.URL; 
     
    public class Test { 
        public static void main(String[] args) { 
            try { 
                URL url = new URL("https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请"); 
                HttpURLConnection connection = (HttpURLConnection)url.openConnection(); 
     
                // 设置请求方式
                connection.setRequestMethod("GET"); 
                connection.connect(); 
     
                // 获取响应码
                int responseCode = connection.getResponseCode(); 
                if (responseCode == HttpURLConnection.HTTP_OK) { 
                    BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); 
                    String line; 
                    while ((line = reader.readLine()) != null) { 
                        // 读取到的内容给line变量 
                        System.out.println(line); 
                    } 
                    reader.close(); 
                } 
            } catch (Exception e) { 
                e.printStackTrace(); 
            } 
        } 
    }
    
    
    
    package main
     
    import (
        "fmt"
        "io/ioutil"
        "net/http"
    )
     
    func main() {
        // 发起一个GET请求
        resp, err := http.Get("https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请")
        if err != nil {
            fmt.Println("http get error", err)
            return
        }
     
        // 读取响应结果
        result, err := ioutil.ReadAll(resp.Body)
        if err != nil {
            fmt.Println("http read error", err)
            return
        }
     
        // 关闭响应结果
        defer resp.Body.Close()
     
        fmt.Println(string(result))
    }
    
    
    
    ```
    # 导入requests库
    import requests
     
    # 设置url
    url = 'https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请'
     
    # 发送post请求
    response = requests.post(url, data={'key1': 'value1', 'key2': 'value2'})
     
    # 获取响应内容
    result = response.json()
     
    # 打印结果
    print(result)
    ```
    
    
    // 以下是使用Node.js进行GET和POST请求API接口的示例代码:
    
    const https = require('https');
    const querystring = require('querystring');
    
    // 定义请求选项
    const options = {
      hostname: 'tji0.com',
      path: '/api/auth/verify',
      method: 'GET'
    };
    
    // 发送GET请求
    https.get(options, res => {
      console.log(`statusCode: ${res.statusCode}`);
    
      res.on('data', d => {
        process.stdout.write(d);
      });
    }).on('error', error => {
      console.error(error);
    });
    
    // 发送POST请求
    const postData = querystring.stringify({
      'key1': 'value1',
      'key2': 'value2'
    });
    
    const postOptions = {
      hostname: 'tji0.com',
      path: '/api/auth/verify',
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Content-Length': Buffer.byteLength(postData)
      }
    };
    
    const postReq = https.request(postOptions, res => {
      console.log(`statusCode: ${res.statusCode}`);
    
      res.on('data', d => {
        process.stdout.write(d);
      });
    });
    
    postReq.on('error', error => {
      console.error(error);
    });
    
    postReq.write(postData);
    postReq.end();
    /*
    这个示例代码使用Node.js内置的`https`模块进行HTTP请求。
    
    首先定义了一个GET请求的选项,然后使用`https.get()`方法发送了GET请求。在响应流上注册回调函数,以便在收到响应数据时将其输出到控制台。在出现错误时,也注册了错误处理程序。
    
    类似地,我们也定义了一个POST请求选项,并使用`https.request()`方法发送它。需要在请求头中包含适当的`Content-Type`和`Content-Length`以确保服务器可以正确解析请求体。请求体由`write()`方法写入,并在请求结束时通过调用`end()`方法通知请求对象已经完成。
    
    注意,此示例默认使用`querystring`模块将数据作为x-www-form-urlencoded格式进行编码。如果需要使用其他格式(如JSON),则需要相应地更改请求头和请求体的编码方式。
    
    另外,为了确保HTTPS请求的安全性,您也可以添加其他选项,例如验证服务器证书、设置代理等。
    */
    
    
    
    
    
    
    以下是使用C语言进行GET和POST请求API接口的示例代码:
    
    ``` c
    #include 
    #include 
    #include 
    #include  // 需要安装curl库
    
    // API地址
    const char* url = "https://tji0.com/api/auth/verify";
    
    // GET请求
    void getRequest(CURL* curl) {
        CURLcode res;
    
        // 设置URL
        curl_easy_setopt(curl, CURLOPT_URL, url);
    
        // 执行请求
        res = curl_easy_perform(curl);
    
        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
        }
    }
    
    // POST请求
    void postRequest(CURL* curl) {
        CURLcode res;
    
        // 设置URL
        curl_easy_setopt(curl, CURLOPT_URL, url);
    
        // 设置POST数据
        const char* postData = "key=你的接口密钥,登录控制台后在密钥管理页面申请&key1=value1";
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
    
        // 执行请求
        res = curl_easy_perform(curl);
    
        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
        }
    }
    
    int main() {
        CURL* curl;
        CURLcode res;
    
        // 初始化curl
        curl = curl_easy_init();
    
        if(curl) {
            // 设置SSL验证
            curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
    
            // GET请求
            getRequest(curl);
    
            // POST请求
            postRequest(curl);
    
            // 清理curl资源
            curl_easy_cleanup(curl);
        }
    
        return 0;
    }
    ```
    
    这个示例代码使用了libcurl库进行HTTP请求。
    
    首先,需要设置API地址。然后,基于`CURL`结构体创建curl句柄,并使用`curl_easy_setopt()`函数设置选项。这里设置了SSL验证,以确保请求的安全性。
    
    在GET请求中,只需将URL设置为选项,然后调用`curl_easy_perform()`函数执行请求即可。
    
    在POST请求中,还需要将POST数据作为字符串传递给`CURLOPT_POSTFIELDS`选项。
    
    需要注意的是,为了避免内存泄漏,应该在使用完curl句柄之后调用`curl_easy_cleanup()`函数进行清理。
    
    除了上述示例代码外,libcurl库还提供了更多高级选项,例如处理HTTP头、上传文件等。可以参考文档进行更详细的了解。
    
    
    
    
    以下是一个使用C++请求API接口的示例代码:
    
    ```cpp
    #include 
    #include 
    
    int main() {
        CURL *curl;
        CURLcode res;
        std::string url = "https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请";
        std::string response;
    
        curl = curl_easy_init();
        if (curl) {
            curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
            curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
            curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](char *ptr, size_t size, size_t nmemb, void *userdata) -> size_t {
                std::string *response = reinterpret_cast(userdata);
                response->append(ptr, size * nmemb);
                return size * nmemb;
            });
            curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
    
            res = curl_easy_perform(curl);
            if (res == CURLE_OK) {
                std::cout << "Response: " << response << std::endl;
            } else {
                std::cerr << "Error: " << curl_easy_strerror(res) << std::endl;
            }
            curl_easy_cleanup(curl);
        }
    
        return 0;
    }
    ```
    
    解释:
    
    1. 引入需要的头文件:``用于输出结果,``用于使用libcurl库。
    
    2. 定义需要请求的API接口的URL和存储响应数据的字符串变量。
    
    3. 初始化一个CURL对象。
    
    4. 设置CURL对象的参数:请求的URL(`CURLOPT_URL`)、是否跟随重定向(`CURLOPT_FOLLOWLOCATION`)、响应数据的写入函数(`CURLOPT_WRITEFUNCTION`)和响应数据的写入位置(`CURLOPT_WRITEDATA`)。
    
    5. 发送HTTP请求并获取响应数据,判断返回状态码是否OK。
    
    6. 清理CURL对象。
    
    运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装libcurl库。
    
    
    
    
    以下是一个使用C#请求API接口的示例代码:
    
    ```csharp
    using System;
    using System.Net.Http;
    using System.Threading.Tasks;
    
    class Program {
        static async Task Main(string[] args) {
            HttpClient client = new HttpClient();
            string url = "https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请";
            HttpResponseMessage response = await client.GetAsync(url);
            if (response.IsSuccessStatusCode) {
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine("Response: " + responseBody);
            } else {
                Console.WriteLine("Error: " + response.StatusCode);
            }
        }
    }
    ```
    
    解释:
    
    1. 引用需要的命名空间:`System.Net.Http`用于使用HttpClient类,`System.Threading.Tasks`用于异步执行请求操作。
    
    2. 创建一个HttpClient对象。
    
    3. 定义需要请求的API接口的URL。
    
    4. 发送GET请求到指定的API接口URL,并获取响应结果。
    
    5. 判断响应状态是否成功,如果成功则读取响应数据(使用ReadAsStringAsync方法),否则输出错误信息(使用StatusCode属性)。
    
    运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装.NET Framework或.NET Core SDK。
    
    
    
    
    以下是VB请求API接口的示例代码:
    
    ```
    ' 1. 引入Microsoft XML v6.0库
    ' 2. 创建一个XMLHTTP对象
    Dim xhr As XMLHTTP
    Set xhr = New XMLHTTP
    
    ' 3. 设置请求的URL、方法,以及是否异步等
    xhr.Open "GET", "https://tji0.com/api/auth/verify?key=你的接口密钥,登录控制台后在密钥管理页面申请", False
    
    ' 4. 发送请求
    xhr.send
    
    ' 5. 获取响应结果
    Dim responseText As String
    responseText = xhr.responseText
    
    ' 6. 输出响应结果
    Debug.Print responseText
    
    ' 7. 释放资源
    Set xhr = Nothing
    ```
    
    在这个示例中,我们创建了一个XMLHTTP对象,用于请求API接口。我们先调用`open`方法来设置请求的URL、方法,以及是否异步。然后,我们发送请求,并使用`responseText`属性来获取响应结果。最后,我们将响应结果打印到控制台,完成操作后释放资源,以防止内存泄漏。请注意,以上示例代码为同步请求,如果想使用异步请求,需要设置第三个参数为`True`,并在请求结束时处理`OnReadyStateChange`事件。
    
    参数名 填写参数值
    评论0
    未登录

    登录 后发表评论

    仅需三步即可快速接入

    1
    在线调试

    填写业务相关参数免费在线调试

    2
    生成代码

    生成符合你的开发语言代码,复制即可

    3
    业务上线

    调整你后端部分逻辑代码即可上线使用

    数据驱动未来

    立即注册

    客服微信

    十七-商务

    请打开手机微信,扫一扫联系我们

    在线咨询
    点击咨询

    工作时间:8:00-24:00

    返回顶部