MiFaZhan
6ed0691134
- docs/apika-shared-token-integration.md（Apika 共享 Token 通道对接说明） - docs/mingqian-integration.md（明千 v3 三方接入操作手册，含本地工作区路径与部署步骤） - docs/mobile-public-token-integration.md（移动公共 Token 通道配置与签名说明） - docs/telecom-v3-apn-integration.md（电信 V3 APN 状态与开停适配，含内部回退记录） - docs/plans/channel-template-model-design.md（通道模板模型设计方案） - docs/plans/telecom-v3-integration-and-switch.md（电信 v1/v3 切换与回退方案，含开发库现状） - docs/scripts/query_sim_card_status.sh、docs/scripts/query_sim_session.sh（内部联调脚本） - docs/sql/*.sql（共享模板迁移与种子 SQL） 保留 docs/config/*.json 通道模板样例（已脱敏，对使用者有参考价值）。 文档站：https://git.5iot.com/iotlcm-public/iotlcm-docs
iotlcm-upstream-chan
配置示例见 build/config.example.yaml 与 config/config.example.yaml。请使用获授权的测试卡。
本地测试
curl -d '{"simKeys":[
{"chanKey":"channel_003",
"iccid":"89860000000000000003",
"imsi":"",
"msisdn":""}
], "reqData":{"yearMonth":"202602"}}' 127.0.0.1:8110/sim/query/sim-datausage-monthly
curl -d '{"simKeys":[
{"chanKey":"channel_003",
"iccid":"89860000000000000003",
"imsi":"",
"msisdn":""}
], "reqData":{"queryDate":"20260201"}}' 127.0.0.1:8110/sim/query/sim-datausage-daily
异步全量消费者直调约定
本月实时累计用量全量同步使用 POST /sim/query/sim-datausage，不经过 Proxy。消费者从卡信息表取得 chanKey 和三码后直接发送：
{
"simKeys": [
{
"chanKey": "channel_003",
"iccid": "89860000000000000003",
"imsi": "",
"msisdn": "1440000000003"
}
],
"reqData": {}
}
一条请求应只包含同一个 chanKey 的卡。响应由 GoFrame 统一包装为 {code,message,data}；data 按输入卡逐项返回，单项 code=0 表示成功，通道或网络等本地错误使用 9999，运营商返回的业务错误码原样保留。data[].resData.dataUsage 已统一为 MB。该接口查询调用时的当前月份，不使用 queryDate；需要指定历史月份时使用独立的月查询接口。