REST API 规则

本文说明 REST API 的通用规则，帮助接入方理解响应格式、错误处理和幂等约定。接入 REST API 请从 REST API 总览 开始阅读。

通用规则

• 当前文档只包含 REST API
• 所有 2xx 成功类响应返回 data
• 所有失败响应省略 data
• message 是人类可读说明，客户端不应基于它做程序分支
• 客户端应基于 HTTP status 和 code 分支
• 继电器控制请求使用 Idempotency-Key 处理重试和重复提交