# 生产环境调用

生产环境使用 `pixiu`（七猫广告后台）或 `baize`（七小猫后台）service，自动使用 QM Apps 平台托管的 Bot token，每次调用必须传 `--env 1`。

## 首次同步

先按[初始化说明](initialization.md)准备 CLI、设置 `SKILL_DIR` 并获取所需后台的规范。按需选择一条同步命令：

```bash
apps-cli api sync pixiu --from-platform true --schema "$SKILL_DIR/assets/pixiu-admin-openapi.yaml"
apps-cli api sync baize --from-platform true --schema "$SKILL_DIR/assets/baize-admin-openapi.yaml"
```

`--from-platform true` 将该 registry 配置为使用平台 Bot 鉴权。已有有效 registry 时直接复用；本地规范已就绪且只做同步时，不必额外登录。即将真实调用生产 API 时，先按初始化说明执行 `apps-cli whoami` 检查平台登录。

## 查询七小猫经营报表

先确认参数，再查询 2026 年、聚合类型为 `2` 的经营报表：

```bash
apps-cli api describe baize Report_QueryBusinessReport
apps-cli api baize Report_QueryBusinessReport \
  --query '{"year":2026,"aggregate_type":2}' \
  --env 1
```

`aggregate_type` 的业务含义以当前 describe 为准；按用户需求选择参数值。

## 查询七猫广告后台财务日收入

以下日期和分页仅为示例，按用户请求修改：

```bash
apps-cli api describe pixiu Report_AdProfitDailyIncomeList
apps-cli api pixiu Report_AdProfitDailyIncomeList \
  --query '{"start_date":"2026-07-01","end_date":"2026-07-03","page":1,"page_size":20}' \
  --env 1
```

生产调用使用 registry 的业务地址。调用其他接口时，也应先 describe，再按接口要求选择 `--query` 或 `--payload`。涉及写入时遵循 [SKILL.md](../SKILL.md) 的授权规则。

## 常见问题

| 问题 | 处理方式 |
| --- | --- |
| 只想看接口参数，是否要登录 | 有本地 registry 时，直接 `api describe`，无需登录或调用业务 API。 |
| 把 `pixiu` 的 `--env` 改成 `0` 能否调用测试环境 | 完整的测试调用需要测试 service、目标 IP 和业务 Host，按[测试环境说明](test-environments.md)组装。 |
| 找不到 operationId | 先确认所选 service，再用 `api list` 查找；需要最新接口时按[初始化说明](initialization.md)刷新规范与 registry。 |
| 平台未登录或登录已失效 | 检查 `apps-cli whoami`，按初始化说明恢复平台会话。 |
| token 过期或 HTTP 鉴权失败 | CLI 会刷新后重试一次；仍失败时报告脱敏错误，不反复重试，也不手动提取 token。 |
| HTTP 200 或 CLI 退出码为 0，但响应中有错误 | 同时检查响应里的业务错误；成功退出本身不足以证明业务成功。 |

恢复会话或修正配置后最多重试原调用一次。CLI 自动注入 Authorization，不打印或手工复制凭据。
