接入教程
各语言接入指南 · 共 23 篇
变量短信与长短信怎么发：模板规范、拆分计费与对账口径
变量短信与长短信的工程做法:变量占位符六个细节(位置与报备一致/填充前校验/空值兜底/JSON转义/批量错位防护/链接不动态)、长短信拆分如何改变计费条数、回执与请求一对多导致对账键必须用request_id+分片序号、批量按分片并发与重试幂等,以及变量与长短信叠加时的五步排查顺序与十一项上线检查单。
短链服务怎么设计：302 跳转、过期策略与短信点击追踪
带链接短信的下游工程:三条约束(域名可自定义、链接逐条报备、不支持动态)推导出的短链服务形态,报备状态机与filing_no硬闸,短链服务四要点(302跳转、过期策略、短码防遍历、峰值扛量),送达回执与点击统计的区别与四层漏斗,以及域名被屏蔽、落地页变更、验证码不带链接三个坑。
短信带链接怎么发：链接报备、签名重算与动态链接边界的工程做法
短信带链接的三个真问题：链接应写进 code 还是 title（两者一个参与签名一个不参与）、改链接要不要重新报备（要，人工终审）、签名与表单编码的先后顺序。另含 1002/1004/1005/1008/1009 排查表与 11 条上线检查单。
短信验证码被刷怎么防：六类攻击、四层防御与接口层的三个坑
短信验证码被刷到一夜五位数账单的原因与防御:六类攻击方式(含最易漏的单号码轰炸)、按性价比排序的四层防御(人机校验/四维频控/风险识别/监控熔断)、验证码设计六个细节,以及接口层三个真实坑——内容必须带签名否则1009、短信通道签名不含tm、业务层重发会与通道自动重发叠加。
人脸核身和身份证二要素核验怎么选：五个判断维度与三层组合方案
人脸核身与身份证二要素核验到底差在哪:一个验人一个验信息,三种活体方案(静默/动作/3D-近红外)的取舍,五类攻击面与防御组合,人脸作为敏感个人信息的四条合规红线,五个判断维度与二要素/三要素/人脸的三层架构设计。
手机号实名认证怎么验：二要素与三要素的区别、在网状态与签名坑
手机号实名认证完整指南:二要素验归属/三要素验三合一/详版验在网状态,为何停机销户仍会一致,两个不报错却误判的签名坑(签名不含phone、idcard末位x要小写),不一致五步排查,按场景选型矩阵与八项上线检查单。
银行卡四要素核验怎么接：二/三/四要素选型、签名坑与结果排查
银行卡四要素核验完整指南:二/三/四要素验的是不同维度(卡归属/身份真实/手机绑定)、四要素签名只算5字段的坑、bankPreMobile参数名、不一致五步排查、卡号掩码存储规范、九项上线检查单。
身份证实名认证 API 常见问题排查：签名、超时与限流的 10 个真实案例
实名认证接口接入期10个高频问题:签名错误三因(排序/时钟/编码)、超时重复计费、高峰超时、批量限流、真名返回不一致、少数民族姓名间隔号。每题给现象-原因-修法,附速查表。
身份证实名认证接口接入全流程：从申请到对账的六个环节
身份证实名认证接口接入全流程:申请开通、接入规范(签名/脱敏/超时)、联调测试四类返回、异常路径四问、上线检查单、对账运维。熟练团队3-5天完成,内链FAQ矩阵与产品页。
贷款申请中的实名认证：从注册核验到反欺诈的六环节设计
信贷场景实名认证六环节方案:注册二要素+手机三要素(贷后可达性地基)、授信人脸核身(含深度伪造检测)、绑卡四要素风控联动、放款卡一致性、贷后改绑手机号二次核验、核验数据反欺诈运用,附十项自查清单。
共享经济从业者核验：网约车三证、骑手底线与家政最严级的分场景方案
共享经济从业者实名认证分场景方案:网约车行政许可三证与背景核查红线、骑手身份+健康证双底线与接单持续验证、家政进家庭最严级,附批量入职四要点(峰值配额/分片熔断/结果分级/幂等对账)与十项自查清单。
医疗健康场景的实名认证：在线问诊、互联网医院与处方流转的身份链设计
医疗实名认证四环节方案:患者分级核验(二要素底线+首诊人脸)、医师身份+执业双层核验、处方流转四环节身份链、儿童就诊监护人绑定,附核验记录留存与十项上线自查清单。
教育行业实名认证怎么接：报名核验、学籍留存、讲师管理与考试防替考
教育机构实名认证的四环节方案:学员报名二要素(含生僻字与未成年人双信息核验)、学籍脱敏留存与审计、讲师公示防冒名、考试人脸防替考,附报名高峰限流与十项上线自查清单。
组合核验怎么设计：手机三要素与银行卡四要素的接口逻辑、计费与错误处理
组合核验是多次调用还是独立接口的判断标准,手机三要素/银行卡四要素的内部逻辑差异(关联查询vs银行通道),结果分级/签名对照/超时配置三个设计要点,与批量组合场景的完整评估清单。
游戏上线前的实名认证与防沉迷接入：三个实名、四条硬指标与一份自检清单
游戏场景实名认证的三层结构(渠道/监管/支付)、防沉迷四条硬指标的技术翻译、核验分流/时段付费联动/数据保护三个设计差异,与上线前 10 项自检清单。
小程序为什么要接身份证实名认证：与微信实名的关系、三段式架构与提审避坑
小程序业务实名与微信支付实名、手机号绑定的区别，身份证二要素核验的三段式架构（appkey 留在服务端、返回码归一化、幂等防重复计费），request 合法域名与隐私声明配置，提审驳回原因与常见坑清单。
Java 接入身份证核验 API 完整指南：签名工具类设计与官方 Demo 的四个改进
Java 后端接入身份证二要素核验接口的完整教程:手写可复用的 MD5 签名工具类(编码/大小写/null 处理三个细节)、JDK 11 HttpClient 零依赖实现、1104 签名排查清单与生产落地建议。
消息通知接口接入指南：签名规则、模板报备与发送频率控制
企业业务通知与动态口令接口的完整接入指南:签名算法(与核验类接口不同,不含 tm)、code 参数的真实含义、模板与签名报备、1005/1008/1009 错误码排查与发送频率控制的三层设计。
身份证核验 API 多语言接入示例:Java / PHP / Python / Go / Node.js 一篇讲透
身份证核验 API 提供 Java / PHP / Python / Go / Node.js 5 种语言接入示例。本文提供完整代码 + 签名生成 + 错误码对照表,开发者可直接复制使用。
API 接口防刷实战:频率限制、IP 白名单、行为验证三层防护
API 防刷三层体系:频率限制(按用户/IP/接口)、IP 白名单与黑名单、行为验证码与业务风控。附验证码接口防刷配置示例。
人脸识别 API 接入完全指南:从 1:1 比对到活体检测一篇讲透
人脸识别 API 通过深度学习模型实现 1:1 比对、1:N 搜索、活体检测三大能力。本文讲清原理、4 大典型应用场景、5 个选型硬指标与接入 4 步流程。
API 签名机制一篇讲透:md5 签名 + mall_id + tm + appkey 的安全原理
API 签名是防止 mall_id 被盗用的第一道防线。本文讲清 md5(mall_id + 业务参数 + tm + appkey) 签名的原理、5 个常见踩坑、与 HTTPS 的差异。
Python 接入身份证核验 API 完整示例
用 Python 调用诺正通身份证二要素核验 API 的完整示例：表单编码请求、md5 签名、末位 X 转小写，以及核验类两层返回结构与常见错误码处理。