快速开始

这个指南帮助你在几分钟内完成第一个 API 调用。按照以下步骤设置认证并开始探索我们的 API。

本示例全部采用CURL的方式进行展示，更多集成方式请参考API文档

前提条件

开始之前请确保您已具备如下条件：

一台正常运行、已接入天青云的逆变器（处于在线状态）
Solinteg Open API 账号与密码：请注意 Solinteg Open API 与 Solinteg Cloud Monitoring System是独立的两套系统，您的Solinteg Cloud Monitoring System的账户不能用于访问Solinteg Open API。
目前暂未开放自助注册，仅面向组织用户提供。如需开通，请通过您的销售代表提出申请，我们会在 1-2 个工作日内回复
- 申请时请提供您的组织名称、创建账户邮箱、用途描述
了解 RESTful API 与 MQTT 协议的基础知识
熟悉逆变器的基本业务，能够理解属性参数、配置参数与遥测数据的含义

环境选择

环境	地址	用途
正式环境	`https://lb.solinteg-cloud.com/openapi/v2`	生产使用

文档站内置了 API 在线调试（Playground）功能：

进入 API 列表中的任意接口
在 Servers 下拉框中选择目标环境
填写参数并点击 Send Request
响应结果会直接展示在页面下方

提示

在 Playground 中发起请求时，可以先调用登录接口获取 token，再将其填入其他接口的 token 认证字段中（该动作填写一次即可，直到Token过期）。

第一次 API 调用

1. 登录获取 Token

这是调用后续所有业务接口（除登录外）的前提

备注

token 具有有效期（60分钟），过期后需重新调用登录接口获取。

curl -L 'https://lb.solinteg-cloud.com/openapi/v2/loginv2/auth' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "authAccount": "user@example.com",
  "authPassword": "123456"
}'

从返回的 body 中取出 token。

{
  "errorCode": 0,
  "info": null,
  "successful": true,
  "body": "eyJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3Nz..."
}

2. 绑定设备

绑定设备需要SN与CheckCode，您可以如下两种方式获取

通过设备的铭牌获取。

如果你同时正再使用天青监控系统，则可以通过设备实时信息界面获取

示例：

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/topic/addTopicMapping?deviceSn=A11230010013204A&topic=%2FAKi0SPuVjN&checkCode=059442' \
-H 'Accept: application/json' \
-H 'token: eyJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3Nz...'

绑定成功

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

3. 验证并查询名下所有设备

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/topic/getDeviceByTopic?topic=%2FAKi0SPuVjN' \
-H 'Accept: application/json' \
-H 'token: eyJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3Nz...'

返回结果中会显示您绑定的所有设备：

{
  "errorCode": 0,
  "info": null,
  "body": [
    {
      "deviceSn": "A11250010094305B",
      "modelType": "M2HT-125K-300"
    }
  ],
  "successful": true
}

4. 查询设备的当前配置参数

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/device/queryDeviceConfigData?deviceSn=A11220010013007C' \
-H 'Accept: application/json' \
-H 'token: eyJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3Nz...'

返回当前这台设备的所有配置参数与属性参数，这些参数决定了逆变器以什么样的方式进行工作。这些参数通常比较稳定。

{
  "errorCode": 0,
  "info": null,
  "body": {
    "deviceType": "STORAGE_INVERTER",
    "firmwareVersion": "V1-0820-0108",
    "checkCode": "426956",
    "communicationMode": "WIFI-/",
    "safetyCountry": 10,
    "inverterReconnectionTime": 31,
    "antiCounterCurrentStartStop": 1,
    "antiReverseCurrentPowerSetting": -1.6,
    "ctRatioSetting": 1200,
    "activePowerLimitE2": 60,
    "pfSettings": 1,
    "firstUnderVoltageValue": 184,
    "firstUnderVoltageTime": 80,
    "firstOverVoltageValue": 276,
    "firstOverVoltageTime": 80,
    "batteryTypeCode": "16#0",
    "peakLoadShiftSwitch": 1,
    "gridMaximumCapacitySet": 60,
    "gridConnectedSocProtection": 1,
    "gridConnectedDischargeDepth": 15,
    "hybridWorkMode": "1#1",
    "masterSlaveFlag": 0,
    "systemControl": 0,
    "offGridOverload": 30,
    "offGridVoltageSet": 230,
    "masterSn": "FFFFFFFFFFFFFFFF",
    "softwareVersion": "5398",
    "hardwareVersion": "8240",
    "rtcTime": "2026-05-20 20:10:37",
    "batCapacity": 61.4,
    "dataLoggerSN": "A1L26001020000A1",
    "dataLoggerTime": "2026-05-20 12:10:39 +0000"
    ...
  },
  "successful": true
}

5. 查询设备的当前遥测数据

该接口获取最近一包遥测数据，代表当前逆变器的工作状态。

curl -L 'http://8.209.107.231:7710/openapi/v2/wrapper/device/queryDeviceRealtimeData?deviceSn=A11250010294305B' \
-H 'Accept: application/json' \
-H 'token: eyJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3Nz...'

{
  "errorCode": 0,
  "info": null,
  "successful": true,
  "body": {
    "invSn": "A11250010094305B",
    "alarms": [],
    "modelType": "M2HT-125K-300",
    "temperature1": 58.6,
    "temperature2": 55,
    "temperature3": 53.7,
    "temperature4": 47,
    "vpv1": 646.7,
    "vpv2": 636.9,
    "vpv3": 624.1,
    "vpv4": 658.3,
    "vpv5": 649.6,
    "vpv6": 700.8,
    "vpv7": 6553.5,
    "vpv8": 6553.5,
    "vpv9": 6553.5,
    "vpv10": 6553.5,
    ...
  }
}

常见问题

认证失败

返回未认证相关错误时，请检查：

请求头中是否携带了 token 字段（注意是自定义的 token 头，而非 Authorization）
token 是否已过期，过期请重新登录获取
是否使用了与账号匹配的环境地址

404 Not Found

接口地址不正确时，请确认：

Base URL 与所选环境一致
接口路径拼写正确
路径参数（如 {deviceSn}）已正确替换

请求频率限制（QPS）

每个接口都有一定的 QPS 限制，请参考API文档

{
  "errorCode": 1,
  "info": {
    "code": "429001",
    "description": "Account-level total rate limit exceeded."
  },
  "body": null,
  "successful": false
}

请在集成时做好重试与退避策略，避免高频调用。

下一步

阅读 EMS 控制相关文档（ToU 模式 / EMS 模式），了解两种控制模式的使用场景
查看 API 列表，了解设备管理、数据查询、设备控制等接口能力
如需帮助，请通过您的销售代表或开发者支持渠道联系我们

前提条件​

环境选择​

第一次 API 调用​

1. 登录获取 Token​

2. 绑定设备​

3. 验证并查询名下所有设备​

4. 查询设备的当前配置参数​

5. 查询设备的当前遥测数据​

常见问题​

认证失败​

404 Not Found​

请求频率限制（QPS）​

下一步​