跳到主要内容

通用设备控制

Solinteg Open API 提供了一个通用参数下发接口，用于控制逆变器。

这适用于一些简单的参数设置。而复杂的参数下发，类似于时间组等，我们更倾向于设计独立的接口供您使用，以屏蔽底层的复杂性。

本文档将使用一些常见的逆变器控制场景来介绍如何使用通用参数下发接口。

接口说明​

  1. 该接口为批量下发接口，您可以一次性将所有设置进行下发。我们也建议您做必要的合并，以减少接口的调用次数，防止触发系统限流。
  2. 参数和参数可能存在依赖关系，并不是下发后就会生效。例如：
    1. 上行功率（gridSideMaxPowerLimit）只有在 上行开关（antiCounterCurrentStartStop） 开启的时候才会生效。
提示

您可以通过我们的监控平台来了解参数之间的依赖关系。

  1. 参数的可设置范围在单机系统和主从并机系统中可能会不同，这往往和系统的额定功率有关。
  2. 通过查询下发结果接口判断下发是否成功时，请使用controlResult字段，不要使用对比currentValue的方式。

场景​

1. 逆变器的快速配置​

下发控制​

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/cmd/set' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'token: <token>' \
-d '{
  "deviceSn": "A11000010054409C",
  "sendSettingItemList": [
    {
      "settingCode": "hybridWorkMode",
      "value": "1#1"
    },
    {
      "settingCode": "antiCounterCurrentStartStop",
      "value": 1
    },
    {
      "settingCode": "gridSideMaxPowerLimit",
      "value": 25
    },
    {
      "settingCode": "safetyCountry",
      "value": 10
    },
    {
      "settingCode": "peakLoadShiftSwitch",
      "value": 1
    },
    {
      "settingCode":"gridMaximumCapacitySet",
      "value": 25
    },
    {
      "settingCode":"batteryTypeCode",
      "value": "1#1"
    }
  ]
}'

响应

{
  "errorCode": 0,
  "info": null,
  "body": "6aa1199626facc51d2f3a46a",
  "successful": true
}

查询下发结果​

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/cmd/checkControlResult?recordId=6aa1199626facc51d2f3a46a' \
-H 'Accept: application/json' \
-H 'token: <token>'

响应

{
  "errorCode": 0,
  "info": null,
  "body": {
    "batterytypecode": {
      "controlResult": true,
      "currentValue": "65537"
    },
    "anticountercurrentstartstop": {
      "controlResult": true,
      "currentValue": "1"
    },
    "safetycountry": {
      "controlResult": true,
      "currentValue": "10"
    },
    "hybirdworkmode": {
      "controlResult": true,
      "currentValue": "257"
    },
    "peakloadshiftswitch": {
      "controlResult": true,
      "currentValue": "1"
    },
    "gridmaximumcapacityset": {
      "controlResult": true,
      "currentValue": "25.0"
    }
  },
  "successful": true
}