常见问题
技术 FAQ · 共 17 篇
接口连不上或返回 404：核验网关与短信主机的地址、路径与三类报错定位
核验类走 api2.nztapi.com，短信走 http://api.nztapi.com/sms.php。路径写错返回 404 HTML 而非错误码，漏传必填参数返回 1108。附四类症状实测对照与联调自查顺序。
接口返回怎么解析：核验类与短信类两套返回结构的差异与统一封装
核验类返回 data.code(字符串)+ status 两层结构，短信类返回扁平的 code(数字)且无 status。同一个 1000/1002 在两套体系里含义完全不同。附统一归一化封装代码与 7 项上线检查单。
接口参数怎么传：7 个端点的必填参数与签名字段对照
核验类与短信 7 个端点的必填参数、参与签名的字段、必填但不参与签名的字段一次列清。附参数名写错返回 1108 而非 1104、title 必填与 OpenAPI required 不一致等 5 个坑。
手机号三要素核验返回 1003/1004/1005：哪一项不一致怎么判、计费与处置
手机号三要素核验详版用 1003/1004/1005 指明哪一项对不上：1003 姓名对证件号错、1004 只有手机号对、1005 证件号对姓名错，三者均计费。含签名不含 phone 的实测对照、tm 与 1107、1003 同号异义的解析层陷阱与上线检查单。
身份证校验位怎么算：ISO 7064 算法、15 位升 18 位与末位 X 传参的 3 个坑
身份证第 18 位校验位的 ISO 7064 MOD 11-2 算法（加权因子表+余数映射表）、15 位升 18 位规则与可直接跑的 Python 实现；末位 X 传参必须转小写 x 否则 1103、校验位通过不等于号码真实、1103 的完整排查顺序。
身份证核验接口的 10 个常见问题：签名、超时、格式与流程排查
身份证核验接入十大高频问题:签名三因(排序/时钟/编码)、超时重复计费、高峰限流、虚假不一致来源、批量数据清洗、失败分层引导、三态流水对账。每题现象-原因-修法。
实名认证记录要保存多久？核验数据留存的合规与工程实践
核验数据留存三层分离(结果/原文/附加采集),人脸照片默认不留存,留存期限跟业务档案周期,脱敏+审计+到期销毁的工程实践,三误区与八项自查清单。
批量实名核验怎么并发？配额、限流与断点续跑的实操配置
批量身份核验三个高频问题:并发数=配额70-80%的分片结构、限流码识别+指数退避+降载恢复的处理三步、幂等键+状态机+结果分级三个必配机制。附批量核验Checklist。
实名认证接口哪家好？供应商对比的 5 个维度
实名认证接口选型五维度框架:数据合规(一票否决)、错误码与接口设计、稳定性替代信号、计费透明度四隐藏变量、服务响应。含选型打分表与真实成本公式,建议至少对比3家。
人脸核身和身份证二要素的区别？什么时候用哪个
人脸核身验人的在场性,身份证二要素验信息真实性。五维度对比(成本/体验/防冒用强度),按风险敞口选型的判断标准,注册二要素+敏感操作人脸的分级组合结构,三个常见误区。
身份证实名认证接口怎么申请？免费试用与开通流程四步走
身份证实名认证接口申请流程:提交申请→资质审核(1个工作日)→开通含100次免费联调额度→正式使用。申请材料清单、审核不通过常见原因、联调测试顺序、上线时间预估。
身份证核验显示不一致？五步排查顺序：从间隔号到批量监控
身份证核验不一致的五步排查:姓名归一化(间隔号冤案)、身份证号格式(末位X/空格/15位)、真伪区分(填错vs证件变更)、修改重填路径设计、批量不一致率监控。前两步解决技术冤案,中间两步救转化。
身份证二要素是什么？核验原理、能验证什么、适用场景一次讲清
身份证二要素核验=姓名+身份证号一致性验证。工作原理、能验证什么不能验证什么、适用场景判断标准、对接三大坑(末位X/间隔号/计费口径)与免费试用申请方式。
接口超时排查决策树：从读超时配置到重试纪律
实名认证类接口四种超时症状的本质区分、四层排查决策树、读超时为何要给到 30 秒、重试三条纪律(一次/退避/带对账)与一个日均 8000 次客户的真实处理案例。
身份证实名认证接口错误码详解：1000-1110 全码表与排查手册
实名认证接口返回 1002、1104、1108 是什么意思?本文给出核验类接口 21 个错误码与短信接口 10 个错误码的完整对照表,附差分排查法,帮助开发者快速定位问题。
短信验证码收不到?延迟、拦截、通道故障 7 种原因与排查方法
短信验证码收不到的 7 种常见原因:号码拦截、通道拥堵、签名被关、携号转网、欠费停机、发送频率限制、通道故障。附开发者和用户两侧的排查清单。
银行卡核验失败原因排查:10 个真实场景与解决方案
银行卡二/三/四要素核验失败有 10 类常见原因。本文按错误码 + 场景给出排查清单与解决方案,助你快速定位问题。