鉴权方式
登录调用使用请求头 access-token。API 调用也可同时发送 api-key 与 api-secret,两者缺一不可。公开接口会在具体页面明确标记为无需鉴权。
通用响应
JSON 接口通常返回 code、msg、 data,分页结果还可能包含 count。现有 v5 行为中,业务错误通常仍返回 HTTP 200,请始终检查 code。
安全调用
页面使用不可调用的 master.example.invalid 示例地址,不保存凭证,也不提供在线发送按钮。复制 curl 示例后,请替换为自己的主控地址,并从安全的运行环境注入凭证。
版本与变更
当前 Reference 与 v5 Python 主控接口保持同步。接口路径、权限或参数发生变化时, 文档会在验证完成后同步更新。