Plant Management API (User Auth)
Plant Management API provides plant creation, modification, and collector/inverter binding/unbinding functions.
Authorization method: User-level Authorization
Basic Information
| Item | Description |
|---|---|
| Authentication | Custom HMAC-SHA1 Signature |
| API Base URL | https://www.soliscloud.com:13333/ |
All endpoints return a unified JSON structure:
json
{
"success": true,
"code": "0",
"msg": "success",
"data": {}
}Update Plant — /v1/api/stationUpdate
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | Number | N | Plant ID |
| stationName | String | Y | Plant name |
| capacity | String | Y | Installed capacity (kWp) |
| addr | String | Y | Plant address |
| price | Number | Y | Price per kWh |
| timeZoneStandardId | String | N | Standard timezone, e.g. Asia/Shanghai |
data returns null.
Create Plant and Bind Collector — /v1/api/addStationBindCollector
| Parameter | Type | Required | Description |
|---|---|---|---|
| stationId | Number | N | Existing plant ID (bind SN if provided) |
| sn | String | N | Collector SN (comma-separated for multiple) |
| stationName | String | Y | Plant name |
| capacity | String | Y | Installed capacity (kWp) |
| userId | Integer | N | Owner ID (default: current account) |
| latitude | String | N | Latitude |
| longitude | String | N | Longitude |
| money | String | Y | Currency |
| addr | String | Y | Plant address |
| price | Integer | Y | Price per kWh |
| timeZoneStandardId | String | N | Standard timezone, e.g. Asia/Shanghai |
data returns the new plant ID (stationId).
Unbind Collector — /v1/api/delCollector
| Parameter | Type | Required | Description |
|---|---|---|---|
| sn | String | N | Collector SN |
| deleteInvert | Integer | Y | 1: Delete all inverters, 0: Don't delete (default) |
data returns null.
Bind Inverter — /v1/api/addDevice
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | Integer | N | Plant ID (one of id/nmiCode required) |
| sn | String | Y | Inverter SN(s), comma-separated |
| nmiCode | String | N | NMI code |
data returns null.
Error Code Reference
For a complete list of code error codes and their descriptions, please refer to Error Codes.
