Page Comparison

Send Generation Data

This endpoint submits generation data for a single device.

此端点用于提交单个设备的发电数据。

Resource information
Response format(s)	JSON
Requires authentication?	Yes using token
Request Header
Name	dataGenerationRequest
`Content-Type`	`application/json`
`Authorization`	`{{token}}`
Parameters
`Data`		This refers to data generation at a particular frequency type ex: [ OrderedMap { "timestamp": "2023-05-01", "periodProductionInKWh": "0.1234" }, OrderedMap { "timestamp": "2023-05-02", "periodProductionInKWh": "0.2345" }, OrderedMap { "timestamp": "2023-05-03", "periodProductionInKWh": "0.4567" } ] 这指的是在特定频率类型下的数据生成例如：[ OrderedMap { "timestamp": "2023-05-01", "periodProductionInKWh": "0.1234" }, OrderedMap { "timestamp": "2023-05-02", "periodProductionInKWh": "0.2345" }, OrderedMap { "timestamp": "2023-05-03", "periodProductionInKWh": "0.4567" } ]
`Timestamp`	`string`	The time to capture data in the format 'YYYY-MM-DD' ex: 2023-04-05 捕获数据的时间，格式为 'YYYY-MM-DD' 例如：2023-04-05
`PeriodProductionInKWh`	`number`	Power generation ex: 0.1234 发电量例如：0.1234
`FrequencyType`	`string`	The type of frequency (i.e., Daily) for data retrieval ex: Daily 数据检索的频率类型（例如，每日）例如：每日目前只支持每日
`AccumulatedPowerInKWh`	`number`	Accumulated Power generation ex: 100.1234
`RemoteInvIdRemoteInverterId`	`string`	This refers to a unique identifier assigned to device or inverter ex: STR1000000033862740 这指的是分配给设备的唯一标识符例如：STR1000000033862740

Response Header
`Content-Type`	`application/json`
Response Body
Field	Type	Description \| 描述
`StatusCode`	`integer`	Code ex: 401 代码例如：401
`Data`
`Message`	`string`	Result message ex: The token is invalid 结果消息例如：令牌无效

Request

Status

colour	Green
title	Post

/public/v2/generation-data

Request

Code Block

language	json

{
  "Data": [
    {
      "Timestamp": "2023-05-01",
      "PeriodProductionInKWh": "0.1234",
      "AccumulatedPowerInKWh": "5.1234"
    },
    {
      "Timestamp": "2023-05-02",
      "PeriodProductionInKWh": "0.2345",
      "AccumulatedPowerInKWh": "5.3579"
    },
    {
      "Timestamp": "2023-05-03",
      "PeriodProductionInKWh": "0.4567",
      "AccumulatedPowerInKWh": "5.8146"
    }
  ],
  "FrequencyType": "Daily",
  "RemoteInvId": "STR10000000338444"
}

Response

Info
200 Success

Code Block

language	json

{
  "Data": {},
  "StatusCode": 200,
  "Message": "Success"
}

Warning
400 Bad Request

Code Block

language	json

{
  "Data": null
  "StatusCode": 400,
  "Message": "Bad Request"
}

Warning
422 Unprocessable Entity

Code Block

language	json

{
  "Data": null,
  "StatusCode": 422,
  "Message": "Unprocessable Entity"
}

Warning
401 Unauthorized

Code Block

language	json

{
  "Data": null,
  "StatusCode": 401,
  "Message": "Unauthorized"
}

Warning
403 Forbidden

Code Block

language	json

{
  "Data": null,
  "StatusCode": 403,
  "Message": "Forbidden"
}

Versions Compared

Old Version 5

New Version 6

Key

Send Generation Data