21 lines
642 B
Markdown
21 lines
642 B
Markdown
# API Skills 使用 Runbook
|
|
|
|
## 标准流程
|
|
|
|
1. 先在 `SKILL.md` 选择领域与场景。
|
|
2. 进入对应 `*/<scenario>/SKILL.md`，按 `Action` 找到接口。
|
|
3. 组装请求：`$BASE_URL` + `path`，并按需带 `AUTH_TOKEN`。
|
|
4. 记录请求参数、状态码、响应体。
|
|
|
|
## 异常处理
|
|
|
|
- `401/403`：检查 token 与角色权限。
|
|
- `404`：检查路径前缀与路由配置是否一致。
|
|
- `422`：检查 query/body 参数与字段类型。
|
|
- `5xx`：记录响应体并关联后端日志排查。
|
|
|
|
## 重试建议
|
|
|
|
- 网络超时、`5xx` 可有限重试 1~2 次。
|
|
- `4xx` 先修正参数与权限，不建议直接重试。
|