主题
扩展错误处理
响应格式规范
所有扩展接口应返回统一的 JSON 格式:
json
{
"success": true,
"message": "操作成功",
"data": {}
}失败时:
json
{
"success": false,
"message": "操作失败:原因描述",
"code": "ERROR_CODE"
}HTTP 状态码规范
| 状态码 | 含义 | SuperUser 行为 |
|---|---|---|
| 200 | 成功 | 显示 message 提示用户 |
| 400 | 请求参数错误 | 显示错误信息 |
| 401 | 未授权 | 提示登录过期 |
| 500 | 服务器错误 | 提示"操作失败" |
| 超时(默认 10s) | - | 提示"请求超时" |
超时配置
在扩展配置中可设置自定义超时时间:
json
{
"label": "生成报告",
"handle": "http://mysite.app/api/report/generate",
"timeout": 30000
}