插座信息查询

通过设备ID查询功率 ,查询电量 ,查询电压 ,查询电流

公共参数

请求地址:
环境 方法 HTTP请求地址
正式环境 GET http://ota.yystart.com/api/pms/device/switch/{deviceId}
头部信息:
名称 类型 是否必须 描述
authId String 用户唯一标识符
authToken String 用户管理凭证

请求参数

名称 类型 是否必须 示例值 描述
deviceId Long 244 设备唯一编号
type Integer 0 查询类型 0:查询功率 1:查询电量 2:查询电压 3:查询电流

响应参数

名称 类型 示例值 描述
value Double 590 根据查询的参数返回对应的值,查询[功率]的单位为[W],[电量]单位为[KWh],[电压]单位为[V],[电流]单位为[mA]
code Integer 0 返回码,0表示成功,其余为失败
msg String success 返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

http://ota.yystart.com/api/pms/device/switch/244?type=0
  • JSON请求示例

										

响应示例

  • JSON成功示例
{
  "value": 590,
  "code": 0,
  "msg": "success"
}

状态码解释

状态码 描述
200 请求成功
400 参数错误(请检查参数名和值是否正确)
401 管理凭证不合法(请检查authId,authToken正确性)
415 MediaType错误(请在header中添加Content-Type:application/json)
500 服务器内部错误(服务器错误,请联系管理员)

插座信息查询(所有)

通过设备ID查询功率 ,查询电量 ,查询电压 ,查询电流

公共参数

请求地址:
环境 方法 HTTP请求地址
正式环境 GET http://ota.yystart.com/api/pms/device/switchInfo/{deviceId}
头部信息:
名称 类型 是否必须 描述
authId String 用户唯一标识符
authToken String 用户管理凭证

请求参数

名称 类型 是否必须 示例值 描述
deviceId Long 244 设备唯一编号

响应参数

名称 类型 示例值 描述
value Double 590 根据查询的参数返回对应的值,查询[功率]的单位为[W],[电量]单位为[KWh],[电压]单位为[V],[电流]单位为[mA]
power Double 590 [功率]的单位为[W],[电量]单位为[KWh],[电压]单位为[V],[电流]单位为[mA]
electricity Double 590 [电量]单位为[KWh]
voltage Double 590 [电压]单位为[V]
electricCurrent Double 590 [电流]单位为[mA]
code Integer 0 返回码,0表示成功,其余为失败
msg String success 返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

http://ota.yystart.com/api/pms/device/switchInfo/244
  • JSON请求示例

										

响应示例

  • JSON成功示例
{
  "power":0.0,
  "electricity":0.05,
  "voltage":0.0,
  "electricCurrent":0.0,
  "code": 0,
  "msg": "success"
}

状态码解释

状态码 描述
200 请求成功
400 参数错误(请检查参数名和值是否正确)
401 管理凭证不合法(请检查authId,authToken正确性)
415 MediaType错误(请在header中添加Content-Type:application/json)
500 服务器内部错误(服务器错误,请联系管理员)

插座/开关控制

通过设备ID控制插座,开关

公共参数

请求地址:
环境 方法 HTTP请求地址
正式环境 POST http://ota.yystart.com/api/pms/device/switch/setting/{deviceId}
头部信息:
名称 类型 是否必须 描述
authId String 用户唯一标识符
authToken String 用户管理凭证
Content-Type String 固定为application/json

请求参数

名称 类型 是否必须 示例值 描述
deviceId Long 244 设备唯一编号
status String 01 需要设定的开关状态位,00:关闭,01:开启

响应参数

名称 类型 示例值 描述
status String 00 开关状态位,00:关闭,01:开启
code Integer 0 返回码,0表示成功,其余为失败
msg String success 返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

http://ota.yystart.com/api/pms/device/switch/setting/244
  • JSON请求示例
{
  "status": "01"
}

响应示例

  • JSON成功示例
{
  "status": "00",
  "code": 0,
  "msg": "success"
}

状态码解释

状态码 描述
200 请求成功
400 参数错误(请检查参数名和值是否正确)
401 管理凭证不合法(请检查authId,authToken正确性)
415 MediaType错误(请在header中添加Content-Type:application/json)
500 服务器内部错误(服务器错误,请联系管理员)