HTTP 开发规范
HTTP 开发规范
请求体、签名和 sign 验算用例已移到 公共约定。那里的技术值与本页原先一致。
1. 接入域名
Imou 开放平台按数据中心提供不同域名。请使用与开发者账号所属数据中心一致的 https://openapi-[DataCenter].easy4ip.com 接入。数据中心见 控制台 - 基本信息 - 我的信息。
| 数据中心 | [DataCenter] | HTTPS POST 接入域名 |
|---|---|---|
| 东亚数据中心 | sg | https://openapi-sg.easy4ip.com/openapi/{method} |
| 中欧数据中心 | fk | https://openapi-fk.easy4ip.com/openapi/{method} |
| 美西数据中心 | or | https://openapi-or.easy4ip.com/openapi/{method} |
{method} 为各接口页给出的方法名。端口 :443 可省略。
2. 最短调用检查清单
- 从 控制台 → 我的应用 → 应用信息 复制
AppId/AppSecret。 - 组装 JSON 请求体并核对
time/nonce：请求约定。 - 在服务端计算
system.sign：签名。 - 调用 accessToken。有效期 3 天；遇到
TK1002再取。 - 看
result.code：返回码。日限额：接口调用限制。 - 第一次走通：首次接口调用。
3. 各接口页的错误码写法
与国内开发文档一致：在 #### 错误码 下用 **`
include 未找到：zh/devcap/errors/….md
** 组合片段（网关、子账号、设备绑定、云存储、DV20xx等），与本页场景匹配；片段定义在.vuepress/fragments/`，与 错误码 分表同源。
- 典型 OpenAPI 页：
gateway+sub-account或dv10-device-base/dv10-bind/st-cloud等 0–2 个上下文片段。 - 能力 property/set/invoke 叶：
gateway+dv20-property-set或dv20-invoke（见各域叶示例）。 - 错误码 为完整 HTTP 索引；能力错误码 为设备侧
DV20xx全表。
禁止仅链码表、无 @[include] 展开内容的小节。