简介

诺正通身份证核验 API 支持二要素（姓名+身份证号）核验。本教程以二要素为例。

准备工作

注册诺正通账号并完成实名

在控制台创建 API Key

安装 requests 库

pip install requests

完整代码

import requests
import hashlib import time
配置
API_KEY = "your_api_key" API_SECRET = "your_api_secret" BASE_URL = "https://api.nztapi.com"
def sign(params: dict) -> str:     """生成签名：按 key 排序后拼接 md5"""     sorted_str = "&".join(f"{k}={v}" for k, v in sorted(params.items()))     return hashlib.md5((sorted_str + API_SECRET).encode()).hexdigest()
def verify_id_card(name: str, id_card: str) -> dict:     """身份证二要素核验"""     params = {         "name": name,         "id_card": id_card,         "timestamp": int(time.time()),     }     params["sign"] = sign(params)
    res = requests.post(         f"{BASE_URL}/v1/id/verify",         json=params,         headers={"Authorization": f"Bearer {API_KEY}"},         timeout=5,     )     res.raise_for_status()     return res.json()
使用
if __name__ == "__main__":     result = verify_id_card("张三", "110101199001011234")     print(result)

响应示例

{
  "code": 0,   "message": "ok",   "data": {     "match": true,     "score": 99.8   } }

错误码

code含义处理建议 0成功- 1001参数错误检查入参 1002余额不足充值 2001数据源异常重试或联系客服 3001签名错误检查签名生成逻辑

下一步

接入成功后，可以查看 API 文档 了解更多接口

遇到问题可提交 工单