Skip to main content

Create a new usage summary task

POST 
/platform/solutions/api/v1/reports/usage-jobs

This task will automatically send a usage summary request for each specified period until the end time. A unique task ID will be generated when the task is created.

You can use the search API to retrieve the task ID and then use the ID to download the report.

The endTime must be later than setting date at least one period.

Limitations

  • repeatPeriod: Daily, Weekly, or Monthly
  • endTime: ISO8601 format YYYY-MM-DD
  • timeZone: +08:30
  • jobs: ActiveDeviceCount or DataPointCount

200 Response

{
    usageJobId: c5177105-e695-49c3-abbf-936c53e9e1da,
    repeatPeriod: Daily,
    endTime: 20251231,
    timeZone: +08:30,
    jobs: [
        ActiveDeviceCount,
        DataPointCount
    ]
}

500 Response

{
    message: end time error.
}

{
    message: end time format error.
}

Request​

Responses​

OK