查询水表信息

通过设备ID查询水表信息

公共参数

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

请求参数

名称 类型 是否必须 示例值 描述
deviceIdLong244设备唯一编号
schTypeInteger1查询类型,0总用水量 1:总购水量 2:剩余水量 3:阀门状态

响应参数

名称 类型 示例值 描述
statusString00电表闸刀状态位(仅查询状态时返回),00:通电 01:断电
valueDouble11.22充值的电量,单位kWh(仅查询电量时返回)
codeInteger0返回码,0表示成功,其余为失败
msgStringsuccess返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

http://ota.yystart.com/api/pms/device/watermeter/244?schType=1
  • JSON请求示例

                                                    

响应示例

  • JSON成功示例
{
  "status": "00",
  "value": 11.22,
  "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/watermeter/setting/{deviceId}
头部信息:
名称 类型 是否必须 描述
authId String 用户唯一标识符
authToken String 用户管理凭证
Content-TypeString固定为application/json

请求参数

名称 类型 是否必须 示例值 描述
deviceIdLong244设备唯一编号
statusString00水表阀门状态位,00:关阀 01:开阀 02:自由控制

响应参数

名称 类型 示例值 描述
codeInteger0返回码,0表示成功,其余为失败
msgStringsuccess返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

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

响应示例

  • JSON成功示例
{
  "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/watermeter/recharge/{deviceId}
头部信息:
名称 类型 是否必须 描述
authId String 用户唯一标识符
authToken String 用户管理凭证
Content-TypeString固定为application/json

请求参数

名称 类型 是否必须 示例值 描述
deviceIdLong244设备唯一编号
valueDouble11.22充值的水量,单位m³

响应参数

名称 类型 示例值 描述
codeInteger0返回码,0表示成功,其余为失败
msgStringsuccess返回信息,成功时信息固定为success,失败为具体的错误信息

请求示例

http://ota.yystart.com/api/pms/device/watermeter/recharge/244
  • JSON请求示例
{
  "value": 11.22
}

响应示例

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

状态码解释

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