Crea o sostituisci un profilo di tetto a livello di organizzazione

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." }

Autorizzazioni

x-api-key

string

header

obbligatorio

Chiave API per-tenant. Il tenant viene derivato dalla chiave — mai dalla richiesta.

Corpo

application/json

startTime

string<date-time>

obbligatorio

Timestamp UTC ISO-8601. Obbligatorio.

Esempio:

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

endTime

string<date-time>

obbligatorio

Timestamp UTC ISO-8601. Deve essere successivo a startTime e nel futuro. Obbligatorio.

Esempio:

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

limitKw

number<float>

obbligatorio

Limite di potenza in kW. Deve essere maggiore di 0. Obbligatorio.

Esempio:

50

priority

integer

predefinito:0

Livello di priorità in stile stack OCPP, da 0 (più bassa) a 10 (più alta). L'invio di un profilo a una priorità già esistente per questo target lo sostituisce.

Intervallo richiesto: 0 <= x <= 10

Esempio:

5

Risposta

Profilo organizzazione creato/sostituito

tenantUuid

string

priority

integer

Esempio:

5

limitKw

number

Esempio:

500

startTime

string<date-time>

endTime

string<date-time>

status

enum<string>

Opzioni disponibili:

SCHEDULED,

ACTIVE,

EXPIRED

note

string

Esempio:

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