核心能力
正反面识别
支持正反两面 9 个字段提取
毫秒级响应
平均 1-3 秒/张(含图片传输)
标准输出
返回标准 JSON 结构,便于二次处理
应用场景
接口参数与签名
诺正通所有接口采用统一的 webservice + MD5 签名鉴权机制, 全面兼容网站、APP、H5、微信小程序。通用鉴权参数、签名规则、返回结构、错误码由所有接口共享, 请前往 开发者中心 - 通用规范 查看完整说明。
🔐 通用鉴权参数(摘要)
所有接口共享 3 个鉴权参数:mall_id(商户ID)、tm(13位毫秒时间戳,防重放)、sign(MD5 签名)。
签名公式:md5(mall_id + 业务参数 + tm + appkey)。
📋 本接口业务参数
| 参数名 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| side | 识别面 | 必填 | front 正面 (人像面) / back 反面 (国徽面) |
| image | 身份证图片 | 必填 | 图片 base64 编码(不要 data:image/jpeg;base64, 前缀),≤4M,jpg/png/bmp |
🔏 签名规则(摘要)
完整签名算法、Java/PHP/Python/Go/Node.js 多语言代码示例已统一整理在开发者中心 - 通用规范 / 签名规则。
📦 返回结构(摘要)
所有接口返回 JSON,包含 data.code(业务结果码)和status(服务状态码)两层。 完整 JSON 示例见通用规范 / 返回结构。
错误码速查表
所有接口共享的错误码体系
完整错误码表(成功 1000 / 不一致 1001 / 鉴权失败 / 账户欠费等 20+ 个 code)已统一整理, 请前往 开发者中心 - 通用规范 / 错误码 查看完整表格和解决方案。
查看完整错误码表 →结构化输出
返回标准 JSON 字段,便于二次处理
与核验联动
提取的身份证号可直接调 v2/id-server 核验
按量计费
无最低消费,按实际识别成功次数计费
常见问题
支持哪些图片格式?▼
支持 jpg/png/bmp 格式,最短边 ≥15px,最长边 ≤4096px,文件 ≤4M。
识别失败会扣费吗?▼
不会。识别失败(错误码 228706)系统自动退回本次调用,不计入消费。
图片会上传到第三方吗?▼
图片数据使用专业 OCR 引擎处理。如需了解数据流向请咨询商务。
可与身份证核验接口联动吗?▼
可以。建议调用顺序:1) 先调 /v1/idcard-ocr/verify 提取身份证号 2) 再用 /v2/id-server 核验姓名+号码一致性。
手机翻拍的图片能识别吗?▼
可以识别,但准确率略低于扫描件(约 92%)。如对准确率要求高,建议客户上传扫描件。