创建或替换组织范围的上限配置文件

curl --request POST \ --url https://api.ridergy.com/v1/organizations/schedules \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "startTime": "2026-06-12T08:00:00Z", "endTime": "2026-06-12T18:00:00Z", "limitKw": 500, "priority": 5 } '

{ "tenantUuid": "<string>", "priority": 5, "limitKw": 500, "startTime": "2023-11-07T05:31:56Z", "endTime": "2023-11-07T05:31:56Z", "note": "Organization-wide cap enforcement is not yet active; this profile is recorded for future use." }

授权

x-api-key

string

header

必填

按租户分配的 API 密钥。租户信息从密钥中获取——绝不来自请求本身。

请求体

application/json

startTime

string<date-time>

必填

ISO-8601 UTC 时间戳。必填。

示例:

"2026-06-12T08:00:00Z"

endTime

string<date-time>

必填

ISO-8601 UTC 时间戳。必须晚于 startTime 且为未来时间。必填。

示例:

"2026-06-12T18:00:00Z"

limitKw

number<float>

必填

功率限制，单位为 kW。必须大于 0。必填。

示例:

50

priority

integer

默认值:0

OCPP 协议栈风格的优先级级别，0（最低）到 10（最高）。如果该目标对象在此优先级下已存在配置文件，再次提交将替换该配置文件。

必填范围: 0 <= x <= 10

示例:

5

响应

组织配置文件已创建/替换

tenantUuid

string

priority

integer

示例:

5

limitKw

number

示例:

500

startTime

string<date-time>

endTime

string<date-time>

status

enum<string>

可用选项:

SCHEDULED,

ACTIVE,

EXPIRED

note

string

示例:

"Organization-wide cap enforcement is not yet active; this profile is recorded for future use."