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是专为您能够查询我们的逆变器品牌集合,并使用此数据去注册分组设备里的设备的逆变器。
Table of Contents
Table of Contents | ||
---|---|---|
|
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 Block | ||
---|---|---|
| ||
{ "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
Code Block | ||
---|---|---|
| ||
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 http状态码,如200,201,404 |
Message text Response message: Success or error message. 返回成功或错误的信息。 |
Example Response
Info |
---|
200 OK |
Code Block | ||
---|---|---|
| ||
{ "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 逆变器品牌名称 (中) |
---|---|---|
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 |
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:
Key: This ensures that rate limits are applied uniquely for each business account id.
Request Limit: Each key is allowed to make up to 5 requests per 5 seconds.
Reset Interval: The limit resets every 5 seconds.
Response Headers:
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
Code Block | ||
---|---|---|
| ||
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 } |