接口名称：人脸身份证比对一所

 
                                                         
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.security.MessageDigest;

/**
 * 人脸身份证比对 - Java 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
 *
 * 说明：本示例只使用 JDK 原生 API（java.net / java.security），不依赖任何第三方 jar 包，
 *      也不需要本项目的工具类，复制到本地即可编译运行：
 *          javac FaceIdCardCheckDemo.java
 *          java FaceIdCardCheckDemo
 */
public class FaceIdCardCheckDemo {

    /** 数勋分配的 appKey，请替换为您自己的 appKey */
    private static final String APP_KEY = "您的appKey";
    /** 数勋分配的 appSecret，请替换为您自己的 appSecret */
    private static final String APP_SECRET = "您的appSecret";
    /** 接口地址 */
    private static final String API_URL = "https://api.shuxuntech.com/v1/faceIdCard/check";
    /** 姓名 */
    private static final String NAME = "";
    /** 身份证号 */
    private static final String ID_CARD = "";
    /** 图片base64 */
    private static final String IMAGE = "";
    /** 图片url */
    private static final String IMG_URL = "";

    public static void main(String[] args) throws Exception {
        // 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
        String timestamp = String.valueOf(System.currentTimeMillis());

        // 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256，得到小写十六进制字符串
        String sign = sha256Hex(APP_KEY + timestamp + APP_SECRET);

        // 3、业务参数，拼成表单内容
        String body = "name=" + urlEncode(NAME) + "&" + "idCard=" + urlEncode(ID_CARD) + "&" + "image=" + urlEncode(IMAGE) + "&" + "imgUrl=" + urlEncode(IMG_URL);

        // 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
        HttpURLConnection conn = (HttpURLConnection) new URL(API_URL).openConnection();
        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
        conn.setRequestProperty("appKey", APP_KEY);
        conn.setRequestProperty("timestamp", timestamp);
        conn.setRequestProperty("sign", sign);
        conn.setConnectTimeout(10000);
        conn.setReadTimeout(20000);
        conn.getOutputStream().write(body.getBytes("UTF-8"));

        int status = conn.getResponseCode();
        // 5、读取返回内容：报错时读错误流，避免只拿到一个异常看不到原因
        InputStream in = (status >= 200 && status < 300) ? conn.getInputStream() : conn.getErrorStream();
        String result = readAll(in);
        conn.disconnect();

        System.out.println("HTTP状态码=" + status);
        System.out.println("返回结果=" + result);
    }

    /**
     * sha256 加密，返回小写十六进制字符串
     * 服务端校验签名用的就是这个算法（小写十六进制）
     */
    private static String sha256Hex(String content) throws Exception {
        byte[] bytes = MessageDigest.getInstance("SHA-256").digest(content.getBytes("UTF-8"));
        StringBuilder sb = new StringBuilder(bytes.length * 2);
        for (byte b : bytes) {
            sb.append(Character.forDigit((b >> 4) & 0xF, 16));
            sb.append(Character.forDigit(b & 0xF, 16));
        }
        return sb.toString();
    }

    /** url 编码，中文参数需要编码 */
    private static String urlEncode(String value) throws Exception {
        return URLEncoder.encode(value, "UTF-8");
    }

    /** 读取输入流内容 */
    private static String readAll(InputStream in) throws Exception {
        if (in == null) {
            return "";
        }
        StringBuilder sb = new StringBuilder();
        BufferedReader reader = new BufferedReader(new InputStreamReader(in, "UTF-8"));
        try {
            String line;
            while ((line = reader.readLine()) != null) {
                sb.append(line);
            }
        } finally {
            reader.close();
        }
        return sb.toString();
    }
}


                                                     

 
                                                         
# 人脸身份证比对 - Python 示例代码
# 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
#
# 说明：只使用 Python 标准库（urllib / hashlib / time），不需要 pip 安装任何第三方包，
#      保存为 face_id_card_check_demo.py 后直接执行 python face_id_card_check_demo.py 即可。

import hashlib
import time
import urllib.error
import urllib.parse
import urllib.request

# 数勋分配的 appKey，请替换为您自己的 appKey
APP_KEY = "您的appKey"
# 数勋分配的 appSecret，请替换为您自己的 appSecret
APP_SECRET = "您的appSecret"
# 接口地址
API_URL = "https://api.shuxuntech.com/v1/faceIdCard/check"
# 姓名
NAME = ""
# 身份证号
ID_CARD = ""
# 图片base64
IMAGE = ""
# 图片url
IMG_URL = ""


def sha256_hex(content):
    """sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法"""
    return hashlib.sha256(content.encode("utf-8")).hexdigest()


def main():
    # 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
    timestamp = str(int(time.time() * 1000))

    # 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
    sign = sha256_hex(APP_KEY + timestamp + APP_SECRET)

    # 3、业务参数
    params = {}
    params["name"] = NAME
    params["idCard"] = ID_CARD
    params["image"] = IMAGE
    params["imgUrl"] = IMG_URL
    data = urllib.parse.urlencode(params)

    # 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
    request = urllib.request.Request(API_URL, data=data.encode("utf-8"), method="POST")
    request.add_header("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8")
    request.add_header("appKey", APP_KEY)
    request.add_header("timestamp", timestamp)
    request.add_header("sign", sign)

    # 5、读取返回内容：报错时也把返回体读出来，避免只拿到一个异常看不到原因
    try:
        with urllib.request.urlopen(request, timeout=20) as response:
            status = response.getcode()
            body = response.read().decode("utf-8")
    except urllib.error.HTTPError as e:
        status = e.code
        body = e.read().decode("utf-8")

    print("HTTP状态码=" + str(status))
    print("返回结果=" + body)

if __name__ == "__main__":
    main()


                                                     

 
                                                         
<?php
/**
 * 人脸身份证比对 - PHP 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
 *
 * 说明：只使用 PHP 内置函数，不需要 composer 安装任何依赖，也不需要 curl 扩展，
 *      保存为 face_id_card_check_demo.php 后直接执行 php face_id_card_check_demo.php 即可。
 */

// 数勋分配的 appKey，请替换为您自己的 appKey
$appKey = "您的appKey";
// 数勋分配的 appSecret，请替换为您自己的 appSecret
$appSecret = "您的appSecret";
// 接口地址
$url = "https://api.shuxuntech.com/v1/faceIdCard/check";
// 姓名
$name = "";
// 身份证号
$idCard = "";
// 图片base64
$image = "";
// 图片url
$imgUrl = "";

// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
$timestamp = sprintf('%.0f', microtime(true) * 1000);

// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
$sign = hash('sha256', $appKey . $timestamp . $appSecret);

// 3、业务参数
$params = array(
    'name' => $name,
    'idCard' => $idCard,
    'image' => $image,
    'imgUrl' => $imgUrl,
);
$body = http_build_query($params);

// 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
$context = stream_context_create(array(
    'http' => array(
        'method' => 'POST',
        'header' => "Content-Type: application/x-www-form-urlencoded; charset=UTF-8\r\n"
            . "appKey: {$appKey}\r\n"
            . "timestamp: {$timestamp}\r\n"
            . "sign: {$sign}\r\n",
        'content' => $body,
        'timeout' => 20,
        // 返回 4xx、5xx 时也把返回体读出来，方便排查
        'ignore_errors' => true,
    ),
));
$result = file_get_contents($url, false, $context);
// 打印结果
if (!empty($http_response_header[0])) {
    echo "HTTP状态=" . $http_response_header[0] . PHP_EOL;
}
echo "返回结果=" . $result . PHP_EOL;


                                                     

 
                                                         
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;

/**
 * 人脸身份证比对 - C# 示例代码
 * 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
 *
 * 说明：只使用 .NET 基础类库（System.Net.Http / System.Security.Cryptography），不依赖任何第三方包。
 *      需要 .NET Framework 4.5 及以上，或 .NET Core / .NET 5 及以上；
 *      保存为 FaceIdCardCheckDemo.cs 后，用 dotnet run 或 VS 控制台项目直接运行即可。
 */
public class FaceIdCardCheckDemo
{
    /** 数勋分配的 appKey，请替换为您自己的 appKey */
    private const string AppKey = "您的appKey";
    /** 数勋分配的 appSecret，请替换为您自己的 appSecret */
    private const string AppSecret = "您的appSecret";
    /** 接口地址 */
    private const string ApiUrl = "https://api.shuxuntech.com/v1/faceIdCard/check";
    /** 姓名 */
    private const string Name = "";
    /** 身份证号 */
    private const string IdCard = "";
    /** 图片base64 */
    private const string Image = "";
    /** 图片url */
    private const string ImgUrl = "";

    public static void Main(string[] args)
    {
        // 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
        long millis = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
        string timestamp = millis.ToString();

        // 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
        string sign = Sha256Hex(AppKey + timestamp + AppSecret);

        // 3、业务参数
        Dictionary<string, string> form = new Dictionary<string, string>();
        form.Add("name", Name);
        form.Add("idCard", IdCard);
        form.Add("image", Image);
        form.Add("imgUrl", ImgUrl);
        string body = ToFormBody(form);

        // 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
        using (HttpClient client = new HttpClient())
        {
            client.Timeout = TimeSpan.FromSeconds(20);
            client.DefaultRequestHeaders.Add("appKey", AppKey);
            client.DefaultRequestHeaders.Add("timestamp", timestamp);
            client.DefaultRequestHeaders.Add("sign", sign);

            StringContent content = new StringContent(body, Encoding.UTF8, "application/x-www-form-urlencoded");
            HttpResponseMessage response = client.PostAsync(ApiUrl, content).GetAwaiter().GetResult();

            // 5、读取返回内容，4xx、5xx 时 HttpClient 不会抛异常，这里同样能拿到返回体
            string resultText = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();

            Console.WriteLine("HTTP状态码=" + (int)response.StatusCode);
            Console.WriteLine("返回结果=" + resultText);
        }
    }

    /** 拼装 application/x-www-form-urlencoded 内容，中文参数需要编码 */
    private static string ToFormBody(Dictionary<string, string> form)
    {
        StringBuilder sb = new StringBuilder();
        foreach (KeyValuePair<string, string> item in form)
        {
            if (sb.Length > 0)
            {
                sb.Append("&");
            }
            sb.Append(Uri.EscapeDataString(item.Key)).Append("=").Append(Uri.EscapeDataString(item.Value));
        }
        return sb.ToString();
    }

    /** sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法 */
    private static string Sha256Hex(string content)
    {
        using (SHA256 sha256 = SHA256.Create())
        {
            byte[] bytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(content));
            StringBuilder sb = new StringBuilder(bytes.Length * 2);
            foreach (byte b in bytes)
            {
                sb.Append(b.ToString("x2"));
            }
            return sb.ToString();
        }
    }
}


                                                     

 
                                                         
// 人脸身份证比对 - Node.js 示例代码
// 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
//
// 说明：只使用 Node.js 内置模块（https / crypto），不需要 npm 安装任何第三方包，
//      保存为 face_id_card_check_demo.js 后直接执行 node face_id_card_check_demo.js 即可（需 Node 10 及以上）。

const https = require('https');
const crypto = require('crypto');

// 数勋分配的 appKey，请替换为您自己的 appKey
const APP_KEY = '您的appKey';
// 数勋分配的 appSecret，请替换为您自己的 appSecret
const APP_SECRET = '您的appSecret';
// 接口地址
const API_URL = 'https://api.shuxuntech.com/v1/faceIdCard/check';
// 姓名
const NAME = '';
// 身份证号
const ID_CARD = '';
// 图片base64
const IMAGE = '';
// 图片url
const IMG_URL = '';

// sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法
function sha256Hex(content) {
    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
}

// 打印返回结果
function printResult(statusCode, body) {
    console.log('HTTP状态码=' + statusCode);
    console.log('返回结果=' + body);
}

// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
const timestamp = String(Date.now());

// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
const sign = sha256Hex(APP_KEY + timestamp + APP_SECRET);

// 3、业务参数，放在请求体里（中文由 URLSearchParams 自动 URL 编码）
const body = new URLSearchParams({ name: NAME, idCard: ID_CARD, image: IMAGE, imgUrl: IMG_URL }).toString();

// 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
const request = https.request(API_URL, {
    method: 'POST',
    headers: {
        appKey: APP_KEY,
        timestamp: timestamp,
        sign: sign,
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
        'Content-Length': Buffer.byteLength(body)
    },
    timeout: 20000
}, function (response) {
    // 5、读取返回内容：即使报错（4xx、5xx）也能拿到返回体，避免只看到异常看不到原因
    let respBody = '';
    response.setEncoding('utf8');
    response.on('data', function (chunk) { respBody += chunk; });
    response.on('end', function () { printResult(response.statusCode, respBody); });
});

request.on('timeout', function () {
    request.destroy();
    console.log('请求超时');
});

request.on('error', function (err) {
    console.log('请求异常=' + err.message);
});

request.write(body);
request.end();


                                                     

 
                                                         
// 人脸身份证比对 - Go 示例代码
// 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
//
// 说明：只使用 Go 标准库（net/http、crypto/sha256、encoding/hex 等），不需要引入任何第三方包，
//      保存为 face_id_card_check_demo.go 后直接执行 go run face_id_card_check_demo.go 即可。
package main

import (
	"crypto/sha256"
	"encoding/hex"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"strings"
	"time"
)

// 数勋分配的 appKey，请替换为您自己的 appKey
const appKey = "您的appKey"

// 数勋分配的 appSecret，请替换为您自己的 appSecret
const appSecret = "您的appSecret"

// 接口地址
const apiURL = "https://api.shuxuntech.com/v1/faceIdCard/check"
// 姓名
const name = ""
// 身份证号
const idCard = ""
// 图片base64
const image = ""
// 图片url
const imgUrl = ""

// sha256 加密，返回小写十六进制字符串，服务端校验签名用的就是这个算法
func sha256Hex(content string) string {
	sum := sha256.Sum256([]byte(content))
	return hex.EncodeToString(sum[:])
}

func main() {
	// 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
	timestamp := fmt.Sprintf("%d", time.Now().UnixNano()/int64(time.Millisecond))

	// 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256
	sign := sha256Hex(appKey + timestamp + appSecret)

	// 3、业务参数，放在请求体里（url.Values 会自动对中文做 URL 编码）
	form := url.Values{}
	form.Set("name", name)
	form.Set("idCard", idCard)
	form.Set("image", image)
	form.Set("imgUrl", imgUrl)
	requestBody := form.Encode()

	// 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
	req, err := http.NewRequest("POST", apiURL, strings.NewReader(requestBody))
	if err != nil {
		fmt.Println("创建请求失败=" + err.Error())
		return
	}
	req.Header.Set("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8")
	req.Header.Set("appKey", appKey)
	req.Header.Set("timestamp", timestamp)
	req.Header.Set("sign", sign)

	client := &http.Client{Timeout: 20 * time.Second}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("请求异常=" + err.Error())
		return
	}
	defer resp.Body.Close()

	// 5、读取返回内容：即使报错（4xx、5xx）也能拿到返回体
	body, _ := io.ReadAll(resp.Body)

	fmt.Println("HTTP状态码=" + resp.Status)
	fmt.Println("返回结果=" + string(body))
}


                                                     

 
                                                         
#!/usr/bin/env bash
# 人脸身份证比对 - curl 示例代码
# 接口地址：https://api.shuxuntech.com/v1/faceIdCard/check
#
# 说明：只依赖系统自带的 curl 和 openssl（用于计算 sha256），不需要安装任何第三方工具，
#      保存为 face_id_card_check_demo.sh 后直接执行 bash face_id_card_check_demo.sh 即可。
#      如果系统没有 openssl，可把下面 SIGN 那一行换成注释里的 sha256sum 写法。

# 数勋分配的 appKey，请替换为您自己的 appKey
APP_KEY="您的appKey"
# 数勋分配的 appSecret，请替换为您自己的 appSecret
APP_SECRET="您的appSecret"
# 接口地址
API_URL="https://api.shuxuntech.com/v1/faceIdCard/check"
# 姓名
NAME=""
# 身份证号
ID_CARD=""
# 图片base64
IMAGE=""
# 图片url
IMG_URL=""

# 1、当前 unix 时间毫秒值，服务端要求与服务器时间相差不能超过 5 分钟
TIMESTAMP=$(($(date +%s) * 1000))

# 2、签名：按顺序拼接 appKey + timestamp + appSecret 后做 sha256，得到小写十六进制字符串
#    没有 openssl 时可用： SIGN=$(printf '%s' "${APP_KEY}${TIMESTAMP}${APP_SECRET}" | sha256sum | awk '{print $1}')
SIGN=$(printf '%s' "${APP_KEY}${TIMESTAMP}${APP_SECRET}" | openssl dgst -sha256 | awk '{print $NF}')

# 3、业务参数放在请求体里（--data-urlencode 会自动对中文做 URL 编码）

# 4、发起 POST 请求，appKey、timestamp、sign 放在请求头
# 5、-w 参数在返回内容后打印 HTTP 状态码，便于查看结果
curl -sS -X POST "${API_URL}" \
    -H "appKey: ${APP_KEY}" \
    -H "timestamp: ${TIMESTAMP}" \
    -H "sign: ${SIGN}" \
    --data-urlencode "name=${NAME}" \
    --data-urlencode "idCard=${ID_CARD}" \
    --data-urlencode "image=${IMAGE}" \
    --data-urlencode "imgUrl=${IMG_URL}" \
    -w "\nHTTP状态码=%{http_code}\n"