开发者指南：学历信息查询API接口调用代码、接入方法及应用场景

# 警告：此处的 'YOUR_ACCESS_ID' 和 'ENCRYPTED_BASE64_DATA' 必须替换为您的真实数据
# ENCRYPTED_BASE64_DATA 是您本地使用 AES-128-CBC 加密并Base64编码后的数据

curl -X POST 'https://apitest.tianyuanapi.com/api/v1/IVYZ9A2B?t=1678886400000' \
-H 'Content-Type: application/json' \
-H 'Access-Id: YOUR_ACCESS_ID' \
-d '{
    "data": "ENCRYPTED_BASE64_DATA"
}'

import requests
import json
import base64
import time
from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad
from Crypto.Random import get_random_bytes

# --- 占位符：请替换为您的真实凭证 ---
ACCESS_ID = "YOUR_ACCESS_ID"
# 16进制的Access Key，需要转换为16字节的bytes
ACCESS_KEY = bytes.fromhex("YOUR_16_BYTE_HEX_ACCESS_KEY")
API_ENDPOINT = "https://apitest.tianyuanapi.com/api/v1/IVYZ9A2B"
# ------------------------------------

def encrypt_data(payload_json: str) -> str:
    """
    使用 AES-128-CBC 加密业务数据

    """
    try:
        # 1. 准备明文和IV
        plaintext_bytes = payload_json.encode('utf-8')
        iv = get_random_bytes(16)  # 生成16字节的随机IV

        # 2. 初始化加密器
        cipher = AES.new(ACCESS_KEY, AES.MODE_CBC, iv)

        # 3. 加密并应用PKCS7填充
        padded_data = pad(plaintext_bytes, AES.block_size, style='pkcs7')
        ciphertext = cipher.encrypt(padded_data)

        # 4. 拼接 IV 和密文
        encrypted_data = iv + ciphertext

        # 5. Base64编码
        return base64.b64encode(encrypted_data).decode('utf-8')

    except Exception as e:
        print(f"加密失败: {e}")
        return None

def decrypt_data(encrypted_base64_data: str) -> str:
    """
    解密AES-128-CBC响应数据

    """
    try:
        # 1. Base64解码
        encrypted_data = base64.b64decode(encrypted_base64_data)

        # 2. 提取IV和密文 (IV为前16字节)
        iv = encrypted_data[:16]
        ciphertext = encrypted_data[16:]

        # 3. 初始化解密器
        cipher = AES.new(ACCESS_KEY, AES.MODE_CBC, iv)

        # 4. 解密并去除PKCS7填充
        decrypted_padded_data = cipher.decrypt(ciphertext)
        decrypted_data = unpad(decrypted_padded_data, AES.block_size, style='pkcs7')

        return decrypted_data.decode('utf-8')

    except Exception as e:
        print(f"解密失败: {e}")
        return None

def query_education_info(name: str, id_card: str):
    """
    调用天远API查询学历信息
    """
    # 1. 准备业务参数
    payload = {
        "name": name,
        "id_card": id_card
    }
    payload_json = json.dumps(payload)

    # 2. 加密数据
    encrypted_request_data = encrypt_data(payload_json)
    if not encrypted_request_data:
        return

    request_body = {
        "data": encrypted_request_data
    }

    # 3. 准备请求头和URL
    headers = {
        "Access-Id": ACCESS_ID,
        "Content-Type": "application/json"
    }
    # 生成13位时间戳
    timestamp = int(time.time() * 1000)
    url = f"{API_ENDPOINT}?t={timestamp}"

    try:
        # 4. 发送POST请求
        response = requests.post(url, headers=headers, data=json.dumps(request_body), timeout=10)

        if response.status_code == 200:
            response_json = response.json()

            # 5. 检查公共响应参数
            if response_json.get("code") == 0 or response_json.get("err_code") == "200":

                # 6. 解密业务数据
                encrypted_response_data = response_json.get("data")
                decrypted_response_str = decrypt_data(encrypted_response_data)

                if decrypted_response_str:
                    print("--- 解密后响应 (Decrypted Response) ---")
                    print(json.dumps(json.loads(decrypted_response_str), indent=4, ensure_ascii=False))
                else:
                    print("错误：响应数据解密失败。")
            else:
                print(f"API请求失败 (业务层面): code={response_json.get('code')}, message={response_json.get('message')}")
        else:
            print(f"HTTP请求失败: 状态码 {response.status_code}")

    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")

# --- 执行查询 ---
if __name__ == "__main__":
    # 使用文档中的示例参数
    query_education_info("张三", "110101199001011234")

{
    "code": 0,
    "message": "ok"
}

{
    "data": {
        "query_id": "202505213797602437204758911904",
        "education_background": {
            "msg": "查询成功有结果",
            "data": [
                {
                    "jsrq": "1806",
                    "xxxs": "普通全日制",
                    "xl": "大学专科",
                    "xxlx": "其他",
                    "zymc": "其他",
                    "ksrq": "1509"
                },
                {
                    "jsrq": "2206",
                    "xxxs": "普通全日制",
                    "xl": "大学本科",
                    "xxlx": "其他",
                    "zymc": "其他",
                    "ksrq": "1809"
                }
            ],
            "code": "9100"
        }
    },
    "err_msg": "请求成功",
    "err_code": "200"
}