[GET] Query REC Transaction Histories

Owned by Que Nguyen
Last updated: Jul 17, 2024 by allen li
4 min read

Table of Contents

Changelogs

Version

Date

Changes by

Description of change

V1.0.0

Jun 24, 2024

Que Nguyen

  • Initiated document

REC Transaction History Resource

绿证交易历史资源

TransactionId text

交易唯一标识符

Transaction unique identifier

交易唯一标识符

TransactionTime datetime

Transaction time

交易时间

Type object

Transaction Type object includes Value Description

交易类型对象，包括交易值描述

Type.Value text

Transaction Type’s Value

交易类型值

Type.Description text

Transaction Type’s Description

交易类型描述

Registry - object

Registry object with Value and Description

注册中心对象，包括值和描述

Registry.Value - text

Registry Value

注册中心值

Registry.Description - text

Registry Description name

注册中心描述

Notes text

Transaction’s note.

交易票据

Details array[object] - array object of REC Transaction Detail Resource

详情 [对象类型数据] - 绿证交易详细资源对象数组

A collections of REC details include RECs information transacted in this transaction

一个包括在此次交易中的绿证信息的详细集合

{ "TransactionId": "TRANS-IREC-RETI-20240522-50N5-00004", "TransactionTime": "2024-05-22T06:54:51.863", "Type": { "Value": "Retirement", "Description": "Retirement" }, "Registry": { "Value": "IREC", "Description": "I-REC" }, "Notes": "", "Details": [ { "AssetName": "Khanh Hoa K1234 Looming", "SerialNumber": "IREC-KHANES20001-VN-2020-0101-0530-1.066602 to 1.069015", "CountryCode": "VN", "Energy": "Wind", "Vintage": "2020", "Total": 0.002414, "RecPrefix": "IREC-KHANES20001-VN-2020-0101-0530", "VintageFrom": "2020-01-01T17:00:00", "VintageTo": "2020-05-30T17:00:00" } ] }

 

REC Transaction Detail Resource

绿证交易详细资源

AssetName text

资产名称

Device or Grouped Device name put into asset that is transacted

包括在交易资产中的设备或者分组设备名称

SerialNumber text

序列号

REC Serial number

绿证序列号

CountryCode text

国家代码

Country alpha code, ISO3166 (VN, CN, …)

国家字符代码，ISO3166（VN, CN, …）

Vintage number

签发期

Vintage year of REC

绿证签发的日期

Total number

总数

Total REC transacted

绿证交易总数

RecPrefix text

REC prefix number

绿证前缀数字

VintageFrom datetime

签发起始时间

Vintage start date.

VintageTo datetime

签发结束时间

Vintage end date.

{ "AssetName": "Khanh Hoa K1234 Looming", "SerialNumber": "IREC-KHANES20001-VN-2020-0101-0530-1.066602 to 1.069015", "CountryCode": "VN", "Energy": "Wind", "Vintage": "2020", "Total": 0.002414, "RecPrefix": "IREC-KHANES20001-VN-2020-0101-0530", "VintageFrom": "2020-01-01T17:00:00", "VintageTo": "2020-05-30T17:00:00" }

 

Meta Pagination Resource

CurrentPage - integer

Current page returned

TotalPage - integer

Total pages by items per page

TotalItems - integer

 Total items number

ItemsPerPage - integer

Total items per page

每页数量

{ "CurrentPage": 1, "TotalPage": 6, "TotalItems": 576, "ItemsPerPage": 100

 

API Definitions

GET /public/v2/inventories/recs/transaction-histories

Request

Headers

Content-Type

application/json

Authorization

Bearer {{access_token}}

Query Parameters

Types (optional) array[text] - enum

类型（可选） 数组[文本] - 枚举

Transaction enum value types

交易枚举值类型

  • Issuance - transaction created upon issuance REC

  • 签发 - 发行绿证时创建的交易

  • Transfer - transaction created upon a transfer between 2 accounts

  • 转账 - 两个账户之间转账时创建的交易

  • Listing - transaction created upon receiving REC imported from other platforms

  • 挂单 - 收到从其他平台导入的绿证后创建的交易

  • Retirement - transaction created upon retiring REC.

  • 核销 - 绿证核销时创建的交易

  • Delisting - transaction created upon exporting REC to other platforms

  • 退单 - 当绿证导出到其他平台时创建的交易

DeviceId (optional) uuid

设别唯一标识符（可选）

Device unique identifier for approved Device or Grouped Device

认证后的设备或者分组设备的唯一标识符

Registry (optional) text

注册中心（可选）

Registry value (IREC, TIGR)

注册中心值（IREC，TIGR）

CountryCodes (optional) array[text]

国家代码

Country alpha codes, ISO3166 (VN, CN, …)

国家字符代码，ISO3166（VN，CN，…）

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.

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.

 

 

 

Response

Response Body

Errors list of error objects

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

Meta pagination resource

Return Pagination Resource

StatusCode integer

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

Message text

Response message: Success or error message.

Data array[object] - array object of REC Transaction Resource

A collection of REC Transaction History Resource

 

 

200 OK

 

401 Unauthorized

 

403 Forbidden

 

 

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: 60 requests per 1 minute(s)

  • Renewal Period: 60 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 60 requests per minute.

    3. Reset Interval: The limit resets every 60 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