一般规则

  • REST API 位于基本 URL 下方:

/public/external/api

  • 所有请求都必须通过 POST 发送。
  • REST API 仅支持通过 HTTPS 提出的请求。
  • 请求必须包含以下标题:
编辑

标题名称



标题值



说明



内容类型



应用程序/json



固定的



授权



123…xyz



API 访问 “选项卡中的 API 密钥



签字



Base64 编码签名



生成的有效载荷的签名。


API 访问 “选项卡中的私人密钥


  • 请求正文必须是一个 json 编码对象,其中必须包含以下值:
编辑

现场



字段示例值



说明



应用程序接口



v2/device/listdevices



应用程序接口名称



时间



1529662725



客户机的 Unix 时间戳(UTC)。


允许的最大时差


客户端和服务器之间的


分钟。


  • 成功后,API 会返回所请求的数据(见下面的查询)和 HTTP 状态代码 200。
  • 如果出现错误,HTTP 状态代码将根据错误的不同在 4xx 和 5xx 之间变化,响应对象将包含一个以 “errors “为关键字的数组,其中包含一系列人类可读的错误信息。
  • 如果没有设备的匹配数据,将返回一个空数组。
  • 如果设备 Id 不存在,返回的数据将为空。
This site is registered on wpml.org as a development site. Switch to a production site key to remove this banner.