跳转到主要内容
POST
/
chargers
/
{controllerUuid}
/
connectors
/
{connectorId}
/
schedules
Create or replace a charger-level limit lock
curl --request POST \
  --url https://api.ridergy.com/v1/chargers/{controllerUuid}/connectors/{connectorId}/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": 11,
  "priority": 5
}
'
{
  "controllerUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "connectorId": "1",
  "limitKw": 11,
  "startTime": "2023-11-07T05:31:56Z",
  "endTime": "2023-11-07T05:31:56Z"
}

授权

x-api-key
string
header
必填

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

路径参数

controllerUuid
string
必填
connectorId
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

响应

充电桩调度配置已创建/替换

controllerUuid
string
示例:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

connectorId
string
示例:

"1"

limitKw
number
示例:

11

startTime
string<date-time>
endTime
string<date-time>
status
enum<string>
可用选项:
SCHEDULED,
ACTIVE,
EXPIRED