创建或替换位置优先级限制配置文件

curl --request POST \ --url https://api.ridergy.com/v1/locations/{locationId}/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": 50, "priority": 5 } '

授权

x-api-key

string

header

必填

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

路径参数

locationId

string

必填

请求体

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

响应

配置文件已创建/替换

locationId

string

示例:

"3632155"

priority

integer

示例:

5

limitKw

number

示例:

50

startTime

string<date-time>

endTime

string<date-time>

status

enum<string>

可用选项:

SCHEDULED,

ACTIVE,

EXPIRED

permanentLimitKw

number | null

示例:

100

effectiveLimitKw

number | null

示例:

50