iotlcm/docs/manual/web/channels.md

通道与接入管理

本章仅供有接入维护权限的平台管理员使用。企业日常查卡、诊断及业务受理通常不需要修改通道。入口为左侧菜单中的“通道模板”和“通道管理”。

通道模板

1. 按模板标识、名称、模型或状态查询已有模板，优先使用已确认可用的模板。
2. 新增时填写模板标识、名称、模型、状态及模板配置。
3. 模型包括 shared_token 和 direct；必须与实际上游接入方式匹配。
4. 模板配置按对应接入实现要求填写有效 JSON，保存后重新查看配置。

模板影响引用它的通道。变更前核对关联通道和兼容性，不在公开手册、截图或工单里展示真实密钥。

新增与维护通道

1. 在“通道管理”新增，填写通道名称、别名、编号、运营商及模板。
2. 按模板要求配置应用标识、密钥、地址等接入信息，不将凭证填入名称或备注。
3. 分别核对通道状态、是否正常、是否轮询、共享 Token 及对接信息；这些配置含义不同，不能互相代替。
4. 保存后打开详情核对，并使用通道测试验证上游返回。
5. 需要时使用“刷新卡数量”，再核对库存、已出库及已销户数量。

未开启共享 Token 的通道修改编号时，系统会提示迁移关联数据并刷新通道实例。确认前核对旧编号、新编号和关联业务，不把它当作仅修改显示名称。已开启共享 Token 的通道不能在页面修改编号。

通道测试

1. 在目标通道点击“测试”，选择“单码直测”“单码补全”或“完整三码”。

   

2. 单码模式选择 ICCID、IMSI 或 MSISDN 并输入对应值；“单码直测”直接使用所填号码调用查询接口，“单码补全”会先查询完整卡信息再测试。“完整三码”需填写同一张卡的 ICCID、IMSI 和 MSISDN。部分电信接口只能按 MSISDN 查询，测试前应选用适合该通道的模式。

   

3. 选择全部测试项或单项测试。测试项包括基础信息、实时会话、卡状态、停机原因、冻结、机卡绑定、设备、区域限制、IMEI、流量及 APN 等。

4. 执行后逐项查看成功、失败或超时结果。需要重试时先核对失败原因，只重试相关项目。

某一查询成功不代表所有上游能力均已支持。测试失败时核对模板、凭证、请求地址、上游授权和卡片所属通道，避免高频重复请求。