Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
stylenone

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
languagejson
{
  "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
languagenone
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

Info

200 OK

Code Block
languagejson
{
  "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

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

  1. 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.

  2. 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

Code Block
languagejson
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
}