标识类字段:票码(一维码/二维码内容规则)、证件号、订单号,需约定编码格式与加密方式,防止明文传输泄露。
票种类字段:日场票、夜场票、年卡、优惠票的编码映射表,由票务方提供、闸机侧维护字典,双方签字确认后冻结变更。
状态类字段:未使用、已核销、已退票、已过期四种状态的枚举值与流转规则,必须写死——已退票被放行、已过期被通过,都是资损事故。核验结果字段:放行、拦截、转人工的返回码定义,以及拦截原因的文案规范。
时间类字段:服务器时间戳格式与时区约定,双方系统时钟需定期对时,防止"票明明有效却提示过期"的低级故障。
联调按五步推进。
第一步:沙箱环境对接——票务方提供测试环境与测试用例集,覆盖正常票、已退票、过期票、伪造票、重复核销五类场景,每类用例留存请求响应截图归档。
第二步:字段字典确认——双方按第三部分逐项核对字段映射,输出《字段对照确认书》。
第三步:压力测试——按最大客流1.5倍发起并发验票,两项硬指标必须达标:识别响应时间≤0.2秒不劣化、人脸识别准确率≥99.9%不下降;同时验证通行状态主动反馈在高并发下无丢包、无延迟堆积。
第四步:断网降级演练——模拟网络中断,验证闸机本地白名单缓存的生效时长、恢复联网后的数据回补机制,回补记录必须与平台侧逐笔对账。
第五步:试运行与验收——小流量真实环境运行3至7天,验票成功率、平均核验时长、异常告警量三项指标连续达标后全量切换。

协议跑得顺,底层能力不能拖后腿。
协议开放性取决于主板与系统架构:全闸机系列统一开发接口、多电机主板通用,配合Windows/Android/Linux全系统SDK,开发团队可在熟悉的语言环境下快速封装;全品类通行验证方式兼容则让"扫码、刷证、人脸"多种核验方式的字段流在同一套协议框架内扩展,而非每加一种方式重写一套接口。
户外项目还需在联调阶段同步验证环境适应性——防水防尘防暴防腐定制结构、304不锈钢厚度≥1.5mm的箱体、伺服无刷电机寿命≥1000万次的耐久配置,硬件不稳,协议再好也守不住峰值。
一是拒绝口头协议——所有字段定义、异常处理、对账机制必须形成书面文档并双方签认;
二是压测不过不上线——节假日峰值不谈判,宁可延期不可带病上线;
三是留好对账抓手——核验流水号全局唯一、双方各存一份,任何资损争议都能逐笔追溯。
检票闸机对接的本质是三件事:协议选型定架构,字段对齐定质量,联调步骤定工期。规范前置,接口对接就不是项目风险点,而是效率杠杆。
17年源头生产厂家通达智,检票闸机软硬件全栈自研,提供接口文档、SDK与联调支持全程配合,可承接单通道小型定制至百通道大型综合项目。