# 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` 和三码后直接发送：

```json
{
  "simKeys": [
    {
      "chanKey": "channel_003",
      "iccid": "89860000000000000003",
      "imsi": "",
      "msisdn": "1440000000003"
    }
  ],
  "reqData": {}
}
```

一条请求应只包含同一个 `chanKey` 的卡。响应由 GoFrame 统一包装为 `{code,message,data}`；`data` 按输入卡逐项返回，单项 `code=0` 表示成功，通道或网络等本地错误使用 `9999`，运营商返回的业务错误码原样保留。`data[].resData.dataUsage` 已统一为 MB。该接口查询调用时的当前月份，不使用 `queryDate`；需要指定历史月份时使用独立的月查询接口。