Skip to content

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

ItemDescription
AuthenticationCustom HMAC-SHA1 Signature
API Base URLhttps://www.soliscloud.com:13333/

All endpoints return a unified JSON structure:

json
{
  "success": true,
  "code": "0",
  "msg": "success",
  "data": {}
}

Update Plant — /v1/api/stationUpdate

ParameterTypeRequiredDescription
idNumberNPlant ID
stationNameStringYPlant name
capacityStringYInstalled capacity (kWp)
addrStringYPlant address
priceNumberYPrice per kWh
timeZoneStandardIdStringNStandard timezone, e.g. Asia/Shanghai

data returns null.

Create Plant and Bind Collector — /v1/api/addStationBindCollector

ParameterTypeRequiredDescription
stationIdNumberNExisting plant ID (bind SN if provided)
snStringNCollector SN (comma-separated for multiple)
stationNameStringYPlant name
capacityStringYInstalled capacity (kWp)
userIdIntegerNOwner ID (default: current account)
latitudeStringNLatitude
longitudeStringNLongitude
moneyStringYCurrency
addrStringYPlant address
priceIntegerYPrice per kWh
timeZoneStandardIdStringNStandard timezone, e.g. Asia/Shanghai

data returns the new plant ID (stationId).

Unbind Collector — /v1/api/delCollector

ParameterTypeRequiredDescription
snStringNCollector SN
deleteInvertIntegerY1: Delete all inverters, 0: Don't delete (default)

data returns null.

Bind Inverter — /v1/api/addDevice

ParameterTypeRequiredDescription
idIntegerNPlant ID (one of id/nmiCode required)
snStringYInverter SN(s), comma-separated
nmiCodeStringNNMI code

data returns null.


Error Code Reference

For a complete list of code error codes and their descriptions, please refer to Error Codes.