# OpenAPI 批次编号

OpenAPI 续费与达量断网配置采用与控制台、小程序一致的编号：三位业务前缀、十四位年月日时分秒、三位当日序列，共二十位。例如 `REN20261012101612016`。

序列使用默认 Redis 的 `iotlcm:batch:no:seq:YYYYMMDD` 键，通过 Lua 原子递增，首次创建设置 48 小时有效期。不同业务前缀共用当日序列，范围为 001 至 999。Redis 不可用或序列超过上限时直接返回错误，不创建批次，不使用本地计数兜底。生成后其他步骤失败可能留下序列空号，这是正常行为。

部署前确认 OpenAPI、控制台和小程序使用同一 Redis 实例及数据库、相同的北京时间配置。仅键名一致不能保证跨服务共享序列。预演与生产必须使用各自隔离的 Redis，不得互相共用。

每日 999 个序列为现有两端规则，本次不扩大额度。API 单卡请求也消耗一个序列，上线前需核对三端合计峰值；如需更高容量，应另行统一调整三端序列宽度与规则。

历史批次号、数据库关联和 worker 消息不迁移，仍按完整批次号查询处理。该改动独立于接口授权检查，不解决权限默认放行问题。