This API are designed for you to be able to query our inverter brands collection. Using this data to register grouped device’s devices' inverters.

这个API是专为您能够查询我们的逆变器品牌集合，并使用此数据去注册分组设备里的设备的逆变器。

1 Table of Contents
2 The Inverter Brand resource
3 API Definitions
- 3.1 Request
- 3.2 Response
4 The Inverters Brands
5 Rate limit
- 5.1 Rate Limiting Overview
  - 5.1.1 Global Policy
  - 5.1.2 Operation Policy
- 5.2 Rate Limit Details
- 5.3 Exceeding the Rate Limit
  - 5.3.1 Example Response When Rate Limit is Exceeded

The Inverter Brand resource

逆变器品牌资源

The primary resource that you will be interacting with when querying the inverter’s brands.

查询逆变器品牌时，您将与之交互的主要资源。

Code text

Inverter's Brand Code

逆变器品牌编码

Name text

Inverter's Brand Name

逆变器品牌名称

{
  "Code": "AB01",
  "Name": "ABB"
}

API Definitions

GET /public/v2/metadata/inverter-brands?Code=AB01&CurrentPage=1&ItemsPerPage=10

Request

Parameters

参数

Code (optional) text

Inverter's Brand Code

逆变器品牌编码

CurrentPage (optional) integer

The page number to retrieve the next set of inverters. The number has to be greater than 1, and will default to 1.

检索下一组逆变器的页码。该数字必须大于1，并且默认为1。

ItemsPerPage (optional) integer

The maximum number of inverter brands to return per page. This number can range from 10 to 100 and defaults to 100.

每页最多返回数在10 - 100之间，默认为100。

Example Request

curl -X GET https://uat-api.redex.eco/public/v2/metadata/inverter-brands?Code=AB01&CurrentPage=1&ItemsPerPage=10 \
     -H 'Authorization: Bearer <access_token>'

Response

Response Body

Data list of inverter brands

A collection of Inverter Brands

逆变器品牌集合

Errors list of error objects

Please see "Getting Started - #Error Object" for more details

请查看Getting Started - #Error Object以获得更多信息。

Meta pagination resource

Return Pagination Resource

返回分页信息

StatusCode integer

Http Status codes standard. Example 200, 201, 404.

http状态码，如200，201，404

Message text

Response message: Success or error message.

返回成功或错误的信息。

Example Response

200 OK

{
  "Data": [
    {
      "Code": "AB01",
      "Name": "ABB"
    }
  ],
  "Meta": {
    "CurrentPage": 1,
    "TotalPage": 1,
    "TotalItems": 1,
    "ItemsPerPage": 100
  },
  "Errors": null,
  "StatusCode": 200,
  "Message": "Success"
}

The Inverters Brands

Code 逆变器品牌编码	Name 逆变器品牌名称 (英）	Local Name 逆变器品牌名称 (中）

Code 逆变器品牌编码	Name 逆变器品牌名称 (英）	Local Name 逆变器品牌名称 (中）
AB01	ABB	ABB
AT02	AISWEI Technology	爱士惟
AE03	Aotai Electric	山东奥太
AS04	Apsystems	昱能科技
BS05	BedinSat	BedinSat
BE06	BelEnergy	BelEnergy
CS07	Canadian solar inverter	加拿大阳光
CP08	Chint Power Systems	正泰电器
DE09	Delta	Delta
DT10	Deye Technology	宁波德业科技
DR11	Dranetz	德兰尼茨
EC12	Ecosolys	Ecosolys
EL13	Elgin	艾尔金
EM14	Empalux	Empalux
FI15	FIMER	费默
FR16	Fronius	伏能士
GL17	Ginlong (Solis)	锦浪科技
GW18	GoodWe	固德威
GT19	Growatt	古瑞瓦特
HE20	Hopewind Electric	禾望电气
HW21	Huawei	华为
IL22	Intelbras	Intelbras
KT23	Kasatech	卡萨特克
KR24	Kstar	科士达
MS25	Minasol	米纳索尔
NS26	NHS Solar	NHS Solar
OT27	Others	其他
PS28	PHB Solar	PHB Solar
PE29	Power Electronics	功率电子
RE30	Renovigi	益邦
SS31	Serrana Solar	Serrana Solar
SE32	Sineng Electric	上能电气
SM33	SMA	SMA
SR34	SOFAR Solar	首航新能源
SG35	SolarEdge	SolarEdge
ST36	SolarTerra	索拉特拉
SX37	SolaX	艾罗能源
SY38	Sumry	三瑞电源
SW39	Sungrow	阳光
SP40	SunLab Power	SunLab Power
TF41	Tanfon	坦方
TB42	TBEA	TBEA
TM43	TMEIC	东芝三菱
TS44	Trina solar inverter	天合光能
VO45	VOLT	VOLT
WE46	WEG	WEG
WH47	WHC	WHC
SA48	SAJ	三晶
HO49	HOYMILES	禾迈
FO50	FOXESS	麦田
PB51	PBI	臻能

Rate limit

Rate Limit Algorithm: Fixed Window

In fixed window rate limiting, a fixed time window (e.g., one minute, one hour) is used to track the number of requests or actions allowed within that window. Requests exceeding the limit are either rejected or throttled until the window resets.

Rate Limiting Overview

Our API employs rate limiting to ensure fair usage and protect the performance and availability of the service. Combination of Global Policy and Operation Policy

Global Policy

Rate Limit: 3000 requests per 5 minute(s)
Renewal Period: 300 second(s)
Key: IP Address
Increment Condition: Any Request

Operation Policy

Rate Limit: 5 requests per 5 seconds(s)
Renewal Period: 5 second(s)
Key: accound-id business account Id.
Increment Condition: Any Request

Rate Limit Details

Rate Limit by Key:
1. Key: This ensures that rate limits are applied uniquely for each business account id.
2. Request Limit: Each key is allowed to make up to 5 requests per 5 seconds.
3. Reset Interval: The limit resets every 5 seconds.
Response Headers:
1. Retry-After: Sent when the rate limit is exceeded, indicating how long to wait before making another request.

Exceeding the Rate Limit

When the rate limit is exceeded, the API will return a 429 Too Many Requests status code. The response will include a Retry-After header specifying the number of seconds to wait before making a new request.

Example Response When Rate Limit is Exceeded

HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

{
    "Data": null,
    "Errors": null,
    "StatusCode": 429,
    "Message": "Rate limit exceeded",
    "Meta": null
}

PUBLIC API Documentation

[GET] Query Inverter Brands

Table of Contents