实时获取

同步特定字段

• Method：PUT

• URL：https://www.einfra.cn/wad/ems/v1/api/common-sync

• 接口描述：请求同步特定字段

• 请求

  • Query参数

  参数	类型	是否必填	描述	范围	样例
  device_uid	str		设备唯一ID	-	xxxxx

  • Body参数

  参数	类型	是否必填	描述	范围	样例
  fields	[]str		同步字段	pcs_total_active_power（更多字段需求请联系物盾）	["pcs_total_active_power"]

  • 示例

cURL

curl --location 
--request PUT 'https://www.einfra.cn/wad/ems/v1/api/common-sync?device_uid=xxxxx' \
--header 'X-API-Key: xxxxx' \
--header 'Content-Type: application/json' \
--data '{
    "fields": ["pcs_total_active_power"]
}'

• 响应

  • application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	获取实时数据成功
    data	object

  • data

    参数	类型	是否必填	描述	范围	样例
    pcs_total_active_power	float		PCS 总输出有功功率（单位：kW）	-	300.0

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误
  400	140008	该设备ID对应的ems设备未找到
  400	140003	不是设备的拥有者，操作权限不足
  400	140002	mqtt超时
  400	140001	mqtt处理失败