Skemi u eżempji tal-API tal-amministrazzjoni

Dan il-fajl jiddefinixxi t-tipi JSON li jistgħu jerġgħu jintużaw u li huma msemmija f'Referenza tal-endpoints. ? ifisser fakultattiv fl-input; | null ifisser li l-proprjetà hija preżenti u tista' tkun null fl-output sakemm l-endpoint li jdawwarha ma jgħidx mod ieħor. DateTime huwa string RFC 3339; id-dati u l-ħinijiet tat-talbiet iridu jinkludu offset.

Tipi primittivi u ta' lookup

PositiveInt = integer > 0
NonnegativeInt = integer >= 0
DateTime = RFC3339 string, for example "2026-08-24T12:30:00Z"
NamedLookup = { id: PositiveInt, name: string }
SiteRef = { id: PositiveInt, name: string|null }
Cost = { currency: string, net: number, tax: number, total: number }

Oqsma futuri mhux magħrufa għandhom jiġu injorati. L-IDs huma numri JSON ħlief cursors opaki u IDs tat-tokens tal-aċċess immaniġġjati mill-portal. L-API ma jirritornax UIDs RFID mhux moħbija, passwords taċ-ċarġers, tokens tal-ispazju tax-xogħol, contractId, sigrieti tal-fornituri jew valuri tal-konfigurazzjoni li jixbhu sigrieti mingħajr ma jaħbihom.

Konverżjoni awtomatika tat-talbiet u proprjetajiet mhux magħrufa

L-API ma japplikax politika globali waħda ta' konverżjoni numerika:

• Kull ID tal-path tar-riżorsi u parametru numeriku tal-query jaċċetta string deċimali bħal "12" meta jissodisfa r-restrizzjoni dokumentata tan-numru sħiħ/firxa.
• countryId tal-ispazju tax-xogħol; countryId/timezoneId tas-sit; oqsma numeriċi tas-sit/konnettur u tal-kmandi taċ-ċarġer; kull qasam numeriku tat-tariffa; u kull qasam numeriku tal-profil tal-iċċarġjar jiġu wkoll ikkonvertiti minn strings numeriċi JSON.
• Il-latitudni/lonġitudni tas-sit, smartMode taċ-ċarġer, in-numri kollha tal-ġestjoni tal-qawwa, in-numri tal-iskeda tar-rapporti u l-IDs u l-valuri tal-bodies tal-utent/RFID/aċċess/limitu/utent lokali jeħtieġu numri JSON u ma jiġux ikkonvertiti awtomatikament.
• L-oġġetti tal-bodies tat-tariffi, il-profili tal-iċċarġjar, l-iskedi tar-rapporti u l-utenti jirrifjutaw proprjetajiet mhux magħrufa b'422. L-oġġetti tal-ispazju tax-xogħol, tas-sit, tal-ġestjoni tal-qawwa, oġġetti oħra taċ-ċarġers/rapporti u oġġetti query jinjoraw proprjetajiet mhux magħrufa.

Dawn id-dettalji huma mġiba tat-trasport tad-data, mhux rakkomandazzjoni: il-klijenti għandhom jibagħtu numri JSON għal oqsma numeriċi tal-body.

Tipi tal-ispazju tax-xogħol u tas-sit

Workspace = {
  id: PositiveInt,
  name: string,
  email: string|null,
  website: string|null,
  address: {
    line1: string|null, line2: string|null, postalCode: string|null,
    city: string|null, state: string|null, countryId: PositiveInt,
    countryCode: string, countryName: string
  },
  createdAt: DateTime,
  updatedAt: DateTime
}

Site = {
  id: PositiveInt,
  name: string,
  description: string|null,
  address: {
    line1: string|null, line2: string|null, postalCode: string|null,
    city: string|null, state: string|null, countryId: PositiveInt,
    countryCode: string, countryName: string
  },
  timezone: { id: PositiveInt, name: string },
  latitude: number|null,
  longitude: number|null,
  chargerCount: integer
}

SiteSession = {
  id: PositiveInt,
  charger: { id: PositiveInt, name: string },
  portId: PositiveInt,
  connectorId: integer,
  active: boolean,
  startedAt: DateTime,
  stoppedAt: DateTime|null,
  durationSeconds: integer|null,
  energyWh: number,
  costs: Cost[]
}

MetricsWindow = {
  from: DateTime, to: DateTime, sessionLimit: integer,
  sessionsIncluded: integer, totalsCapped: boolean
}

GET /sites/:siteId jirritorna { site, recentSessions, totals, metricsWindow }. Il-site tiegħu jżid stat taċ-ċarġers/konnetturi taħt is-sjieda mal-projezzjoni bażi tas-sit; totals fih sessions, energyWh, energyKwh, durationSeconds u costs: Cost[].

Il-lookups tas-siti huma { countries: {countryId, countryCode, name}[], timezones: {timezoneId, name}[] } b'IDs numeriċi u ismijiet/kodiċijiet string.

DashboardSession = {
  id: PositiveInt, chargerId: PositiveInt, connectorId: PositiveInt,
  userId: PositiveInt|null, userName: string|null, chargerName: string|null,
  site: SiteRef|null, status: string|null, energyWh: number,
  startedAt: DateTime|null, stoppedAt: DateTime|null,
  costs: Array<{ currency: string|null, price: number, tax: number }>
}

Dashboard = {
  window: { from: DateTime, to: DateTime, maxSessions: 1000 },
  stats: { chargerCount: integer, onlineChargerCount: integer, siteCount: integer, userCount: integer },
  sessions: DashboardSession[],
  analytics: {
    totals: { sessions: integer, energyWh: number, durationSeconds: integer, costs: Array<{currency:string, amount:number}> },
    daily: Array<{ date:string, sessions:integer, energyWh:number, costs:Array<{currency:string, amount:number}> }>,
    sites: Array<{ id:PositiveInt, name:string|null, sessions:integer, energyWh:number, costs:Array<{currency:string, amount:number}> }>,
    chargers: Array<{ id:PositiveInt, name:string|null, siteId:PositiveInt|null, siteName:string|null, sessions:integer, energyWh:number, costs:Array<{currency:string, amount:number}> }>
  }
}

SiteDetailCharger = {
  id: PositiveInt, name: string|null, identifier: string|null, status: string,
  connection: { lastSeenAt: DateTime|null, leaseExpiresAt: DateTime|null }|null,
  connectors: Array<{ evseId:PositiveInt, evseNumber:integer, portId:PositiveInt, connectorId:integer, status:string|null }>,
  sessionCount: integer,
  totals: { sessions:integer, energyWh:number, energyKwh:number, durationSeconds:integer, costs:Cost[] }
}

Eżempju ta' patch u rispons tal-ispazju tax-xogħol:

PATCH /v2/admin
Authorization: Bearer evc_ws_<selector>.<secret>
Idempotency-Key: workspace-contact-20260824
Content-Type: application/json

{"email":"ops@example.com","city":"Riga"}

{
  "workspace": {
    "id": 7,
    "name": "Example CPO",
    "email": "ops@example.com",
    "website": null,
    "address": {
      "line1": "1 Example Street",
      "line2": null,
      "postalCode": "LV-1001",
      "city": "Riga",
      "state": null,
      "countryId": 1,
      "countryCode": "LV",
      "countryName": "Latvia"
    },
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-08-24T12:30:00.000Z"
  }
}

Eżempju ta' ħolqien/aġġornament ta' sit (oqsma b'valuri predefiniti jistgħu jitħallew barra):

{
  "name": "Main depot",
  "addressLine1": "1 Example Street",
  "city": "Riga",
  "countryId": 1,
  "timezoneId": 1,
  "latitude": 56.9496,
  "longitude": 24.1052
}

Rispons tal-ġestjoni tal-qawwa

PowerConfiguration = {
  site: { id: PositiveInt, updatedAt: DateTime },
  chargepoints: Array<{
    id: PositiveInt, name: string|null,
    compatible: boolean, compatibility: string, // values come from shared capability projection
    ...additional smart-charging capability flags
  }>,
  pools: Array<{
    id: PositiveInt, parentId: PositiveInt|null, name: string|null,
    limit: integer, defaultLimit: integer|null, mode: integer|string|null
  }>,
  assignments: Array<{
    poolId: PositiveInt, chargepointId: PositiveInt, priority: integer,
    chargingProfileId: PositiveInt|null,
    chargingProfileSynced: integer|null,
    limit: number|null
  }>,
  meterSources: Array<{
    id: PositiveInt, poolId: PositiveInt, sourceId: PositiveInt,
    provider: string, name: string|null, externalId: string,
    measurementMode: string, valueMode: string,
    reserveA: integer, offlineSafeA: integer, ttlSeconds: integer,
    enabled: boolean, lastComputedLimitA: number|null,
    lastComputedAt: DateTime|null, lastStatus: string|null,
    lastSeenAt: DateTime|null, effectiveLimitA: number|null
  }>,
  connectors: Array<{
    id: PositiveInt, connectorId: integer, chargepointId: PositiveInt,
    status: string|null
  }>
}

L-ismijiet eżatti tal-oqsma addizzjonali tal-kompatibbiltà jiġu prodotti minn smartChargingCompatibility(); it-tip tar-ritorn ta' dak il-helper mhuwiex imsemmi espliċitament fis-sors. Dan huwa l-uniku framment tar-rispons li l-lista magħluqa tal-oqsma tiegħu ma tistax tiġi determinata minn tip esportat, għalhekk oqsma addizzjonali huma intenzjonalment immarkati bħala mhux ċari minflok jiġu vvintati.

Eżempju ta' sostituzzjoni:

{
  "pools": [
    {
      "name": "Depot supply",
      "limit": 125,
      "meterSources": [
        {
          "externalId": "meter-42",
          "measurementMode": "available_headroom",
          "enabled": true
        }
      ],
      "children": [
        {"chargepointId": 11, "priority": 10},
        {"name": "Secondary", "limit": 32, "children": []}
      ]
    }
  ]
}

Tipi ta' ċarġers

Charger = {
  id: PositiveInt, name: string, identifier: string, cpoId: PositiveInt,
  site: { id: PositiveInt, name: string }, status: string,
  isPublic: boolean, invertedRfid: boolean, smartMode: integer,
  automationDisabled: boolean, provisioned: boolean,
  connection: {
    protocol: string|null, lastSeenAt: DateTime|null, leaseExpiresAt: DateTime|null
  } | null,
  evses: Array<{ id: PositiveInt, number: integer, status: string|null }>,
  connectors: Array<{
    evseId: PositiveInt, evseNumber: integer, status: string|null,
    id: PositiveInt, connectorId: integer, portNumber: integer,
    format: { id: PositiveInt, name: string, description: string|null },
    type: { id: PositiveInt, name: string, description: string|null },
    powerType: { id: PositiveInt, name: string, description: string|null },
    maxVoltage: number, maxAmperage: number, maxElectricPower: number,
    maxPowerKw: number
  }>,
  createdAt: DateTime, updatedAt: DateTime
}

ChargerDetail = Charger & {
  configuration: Array<{
    chargepointConfigId: PositiveInt, key: string,
    value: string|null, readonly: boolean|number, setByServer: boolean|number,
    modified: DateTime
  }>,
  firmware: { status: string|null, statusAt: DateTime|null, version: string|null, bootAt: DateTime|null },
  counts: { localUsers: integer, sessions: integer, tariffAssignments: integer, profileAssignments: integer }
}

Il-projezzjoni tal-lista żżid oqsma metriċi limitati u tirritorna metricsWindow; il-projezzjoni tad-dettall tuża l-istruttura ta' hawn fuq. Il-valuri tal-konfigurazzjoni għal ċwievet sensittivi huma eżattament "[REDACTED]".

PublicReadiness = {
  ready: boolean,
  missingRequirements: Array<"site_coordinates"|"connector_tariffs"|"billing_plan"|"stripe_connect"|"legacy_payment_data">,
  commercialGateEnabled: boolean, siteCoordinatesDefined: boolean,
  allConnectorsHaveTariffs: boolean, connectorsMissingTariffs: integer[],
  connectorCount: integer, paymentDataDefined: boolean,
  billingAccountId: PositiveInt|null, planCode: string|null,
  billingPlanEligible: boolean, stripeConnectReady: boolean,
  stripeConnectState: "active"|"action_required"|"pending"|"not_configured",
  connectorIds: integer[], missingTariffConnectorIds: integer[]
}

RedactedOcppLog = {
  ocppServerLogId: PositiveInt, timestamp: DateTime, logLevelId: PositiveInt,
  logAction: string|null, logDirection: string|null, logMessage: string|null,
  messageId: string|null, transactionLogId: PositiveInt|null,
  logLevel: { name:string }|null
}

CompositeSchedule = {
  id: PositiveInt, chargepointId: PositiveInt, connectorId: integer,
  evseId: PositiveInt|null, scheduleStart: DateTime, duration: integer,
  minChargingRate: number|null, chargingRateUnitId: PositiveInt,
  chargingRateUnit: string|null, chargingRateUnitDescription: string|null,
  periods: Array<{ id:PositiveInt, startPeriod:number, limit:number, numberPhases:integer|null, phaseToUse:integer|null }>
}

Patch ta' konnettur li jirnexxi jirritorna eżattament { portId, connectorId, ocpiConnectorFormatEnumId, ocpiConnectorTypeEnumId, ocpiPowerTypeEnumId, maxVoltage, maxAmperage, maxElectricPower }.

connectorLookups fih dawn l-istrutturi tal-lookup: il-formati jużaw { ocpiConnectorFormatEnumId, name, description }; it-tipi jużaw { ocpiConnectorTypeEnumId, name, description, icon }; it-tipi tal-qawwa jużaw { ocpiPowerTypeEnumId, name, shortDescr, description, numPhases }.

Eżempji ta' ħolqien u aġġornament tal-konnettur:

{"name":"Warehouse 1","identifier":"cp-warehouse-1","password":"initial-secret","siteId":3}

{
  "connectorFormatId": 1,
  "connectorTypeId": 2,
  "powerTypeId": 1,
  "maxVoltage": 400,
  "maxAmperage": 32,
  "maxElectricPower": 22000
}

L-oġġetti tar-risponsi tal-kmandi fihom status: string. It-trigger fih ukoll connectorResults: { connectorId: number, status: string }[]; l-iskeda komposta fiha wkoll connectorId u compositeSchedule (jew null). Il-valuri tal-istatus huma riżultati OCPP/ta' operazzjonijiet sussegwenti maħżuna u r-rotta ma tillimitahomx għal enum magħluq.

Tipi ta' rapporti

ReportSession = {
  id: PositiveInt,
  charger: { id: PositiveInt, name: string, site: { id: PositiveInt, name: string }|null },
  portId: PositiveInt, connectorId: integer,
  user: { id: PositiveInt, name: string }|null,
  active: boolean, energyWh: number,
  startedAt: DateTime, stoppedAt: DateTime|null,
  durationSeconds: integer|null, costs: Cost[]
}

ReportSchedule = {
  id: PositiveInt, workspaceId: PositiveInt, enabled: boolean,
  recipientEmail: string, format: "csv"|"pdf", sendDay: integer,
  sendTime: string, createdAt: DateTime, updatedAt: DateTime,
  lastDeliveryPeriod: string|null, lastDeliveryStatus: string|null,
  lastDeliveryAttemptAt: DateTime|null, lastDeliveryAttemptCount: integer,
  lastDeliveredPeriod: string|null, lastDeliveredAt: DateTime|null
}

ReportDataResponse = {
  items: ReportSession[],
  pageTotals: { sessions:integer, energyWh:number, durationSeconds:integer, costs:Cost[] },
  page: { limit:integer, nextCursor:string|null },
  range: { from:DateTime, to:DateTime, toExclusive:true }
}

MeasurementPoint = { meterValueId:PositiveInt, timestamp:DateTime, elapsedSeconds:integer, value:number }
Measurement = {
  name:string,
  unit:{ symbol:string|null, description:string|null },
  lines:Array<{ phase:string, points:MeasurementPoint[] }>
}
MeasurementsResponse = {
  transactionLogId:PositiveInt, measurements:Measurement[],
  page:{ limit:integer, nextCursor:string|null, sampleValuesTruncated:boolean, sampleLimitPerMeterValue:64 }
}

Eżempju ta' talba u rispons tal-iskeda:

{"enabled":true,"recipientEmail":"reports@example.com","format":"csv","sendDay":5,"sendTime":"08:30"}

{
  "schedule": {
    "id": 4,
    "workspaceId": 7,
    "enabled": true,
    "recipientEmail": "reports@example.com",
    "format": "csv",
    "sendDay": 5,
    "sendTime": "08:30",
    "createdAt": "2026-08-01T10:00:00.000Z",
    "updatedAt": "2026-08-24T12:30:00.000Z",
    "lastDeliveryPeriod": null,
    "lastDeliveryStatus": null,
    "lastDeliveryAttemptAt": null,
    "lastDeliveryAttemptCount": 0,
    "lastDeliveredPeriod": null,
    "lastDeliveredAt": null
  }
}

Tipi ta' tariffi

TariffComponent = {
  id: PositiveInt,
  type: NamedLookup, season: NamedLookup,
  validFromMonth: number|null, validToMonth: number|null,
  validFromWeekDay: number|null, validToWeekDay: number|null,
  validFromHour: number|null, validToHour: number|null,
  priority: number, price: number
}

Tariff = {
  id: PositiveInt, cpoId: PositiveInt, name: string,
  type: NamedLookup,
  site: { id: PositiveInt, name: string, timezone: string|null }|null,
  currency: { id: PositiveInt, code: string, sign: string },
  biddingZone: { id: PositiveInt, code: string, name: string }|null,
  tax: number, fallbackPrice: number|null, price: number|null,
  components: TariffComponent[], assignmentCount: integer
}

TariffAssignment = {
  id: PositiveInt, chargerId: PositiveInt, connectorId: integer,
  tariff: { id: PositiveInt, name: string, currency: { code: string, sign: string } },
  createdAt: DateTime, updatedAt: DateTime
}

MarketPrice = {
  id: PositiveInt, value: number, currencyId: PositiveInt,
  startsAt: integer, endsAt: integer,
  startsAtIso: DateTime, endsAtIso: DateTime, intervalMinutes: number
}

TariffLookups = {
  currencies:Array<{id:PositiveInt,code:string,sign:string,fractionalUnit:string,enabled:boolean,minimalValue:integer}>,
  biddingZones:Array<{id:PositiveInt,code:string,name:string,currencyId:PositiveInt,enabled:boolean}>,
  currencyRates:Array<{currencyId:PositiveInt,rate:number,updatedAt:DateTime}>,
  componentTypes:NamedLookup[], seasons:NamedLookup[], tariffTypes:NamedLookup[]
}

Eżempji ta' tariffi u komponenti:

{"name":"Public AC","currencyCode":"EUR","biddingZoneId":1,"tax":21}

{
  "components": [
    {"typeId":1,"seasonId":1,"priority":0,"price":0.25,"validFromHour":0,"validToHour":24}
  ]
}

Tipi ta' profili tal-iċċarġjar

SchedulePeriod = { id: PositiveInt, startPeriod: number, limit: number, numberOfPhases: integer|null }

ChargingProfile = {
  id: PositiveInt, cpoId: PositiveInt, label: string, description: string|null,
  stackLevel: number, location: NamedLookup, purpose: NamedLookup,
  kind: NamedLookup, recurrency: NamedLookup|null,
  validFrom: DateTime|null, validTo: DateTime|null,
  startSchedule: DateTime|null, durationSeconds: number|null,
  rateUnit: NamedLookup, minChargingRate: number|null,
  schedule: SchedulePeriod[], assignmentCount: integer,
  createdAt: DateTime, updatedAt: DateTime
}

ProfileAssignment = {
  id: PositiveInt, chargerId: PositiveInt, connectorId: integer,
  synced: boolean, syncCode: integer,
  syncStatus: "accepted"|"rejected"|"unknown",
  profile: { id: PositiveInt, label: string, stackLevel: number, purpose: string, kind: string|null },
  createdAt: DateTime, updatedAt: DateTime
}

ChargingProfileLookups = {
  locations:NamedLookup[], purposes:NamedLookup[], kinds:NamedLookup[],
  recurrencyKinds:NamedLookup[],
  rateUnits:Array<{id:PositiveInt,name:string,supported:boolean}>,
  allowedRateUnits:string[]
}

Eżempji ta' ħolqien u skedar:

{
  "label":"Depot cap","locationId":3,"stackLevel":1,"purposeId":1,"kindId":1,
  "recurrencyKindId":null,"validFrom":null,"validTo":null,"startSchedule":null,
  "rateUnitId":1,"minChargingRate":6,
  "schedule":[{"startPeriod":0,"limit":32,"numberOfPhases":3}]
}

{"rateUnitId":1,"periods":[{"startPeriod":0,"limit":16,"numberOfPhases":3}]}

Tipi ta' utenti

RFID = { id: PositiveInt, maskedUid: string, name: string|null, type: string, valid: boolean }
AccessItem = { id: PositiveInt, chargerId: PositiveInt, chargerName: string, expiresAt: DateTime|null, site: SiteRef|null }
Access = { allChargers: boolean, chargerIds: PositiveInt[], items: AccessItem[] }
Limit = { id: PositiveInt, limitTypeId: PositiveInt, label: string, energyValue: integer, timeValue: integer }

User = {
  id: PositiveInt, membershipId: PositiveInt, name: string, email: string,
  rfids: RFID[], access: AccessItem[], limitCount: integer
}

UserDetail = User & {
  phone: string|null, createdAt: DateTime|null, limits: Limit[]
}

Vehicle = {
  id: PositiveInt, name: string|null, provider: string|null, status: string|null,
  vin: string|null, identifier: string|null, model: string|null,
  batteryCapacityWh: number|null, createdAt: DateTime,
  telemetry: { soc: number|null, chargeLimitSoc: number|null, recordedAt: DateTime|null }|null
}

LocalUser = {
  id: PositiveInt, customerId: PositiveInt, name: string, email: string,
  expiresAt: DateTime|null, systemManaged: boolean
}

LocalUserMutation = {
  chargepointLocalUserId: PositiveInt,
  customerId: PositiveInt,
  expiryDate: DateTime|null,
  customer: {} // `contractId` is removed by the workspace-admin response boundary
}
LocalUserUpdate = { id:PositiveInt, customerId:PositiveInt, expiresAt:DateTime|null }

Invitation = {
  email:string, name:string, chargerIds:PositiveInt[], rfids:string[]
}

UserListResponse = {
  items:User[], invitations:Invitation[], chargers:Array<{id:PositiveInt,name:string,identifier:string|null,site:SiteRef|null}>,
  page:{ nextCursor:number|string|null, memberNextCursor:number|null, invitationNextCursor:string|null, limit:integer }
}

UserSession = {
  id:PositiveInt, chargerId:PositiveInt, chargerName:string|null,
  connectorId:PositiveInt, site:SiteRef|null, energyWh:number,
  startedAt:DateTime|null, stoppedAt:DateTime|null
}

Ir-rispons tal-mutazzjoni għal POST /chargers/:chargerId/local-users u r-riżultat tal-klijent eżistenti ta' POST /chargers/:chargerId/local-users/invitations jirritornaw LocalUserMutation; PATCH /chargers/:chargerId/local-users/:localUserId jirritorna LocalUserUpdate. L-endpoint tal-lista juża LocalUser. Il-klijenti għandhom iqisuhom bħala tipi tar-rispons intenzjonalment distinti.

Eżempji ta' utenti/istediniet/RFID/aċċess:

{"email":"driver@example.com","name":"Example Driver"}

{
  "email":"new.driver@example.com",
  "name":"New Driver",
  "rfid":"04AABBCCDD",
  "allChargers":false,
  "chargerIds":[11,12]
}

{"uid":"04AABBCCDD","name":"Blue card"}

{"allChargers":false,"chargerIds":[11,12]}

Kitbiet li jirnexxu qatt ma jirritornaw l-UID RFID mhux moħbi. Pereżempju:

{"rfid":{"id":31,"maskedUid":"******CCDD","name":"Blue card","type":"RFID","valid":true}}

Bodies ta' suċċess vojta u binarji

• 204 ifisser ebda body tar-rispons.
• Suċċess tal-QR taċ-ċarġer jirritorna bytes PNG, mhux JSON.
• Suċċess tal-esportazzjoni tar-rapport huwa bytes CSV jew PDF, mhux JSON.
• Ara Kuntratt tar-risponsi u l-iżbalji għall-bodies JSON irritornati meta wieħed miż-żewġ endpoints binarji jfalli.

Eżempji oħra ta' payloads tal-mutazzjonijiet

Il-paths f'din it-tabella ta' eżempji biss huma relattivi għal /v2/admin; il-paths sħaħ jinsabu f'Referenza tal-endpoints. L-eżempji itwal ta' hawn fuq ikopru l-ispazju tax-xogħol, is-sit, il-ġestjoni tal-qawwa, il-ħolqien taċ-ċarġer/settings tal-konnettur, skedi tar-rapporti, tariffi/komponenti, profili tal-iċċarġjar/skedi, utenti/istediniet, RFID u sostituzzjoni tal-aċċess. Kull mutazzjoni oħra b'body tuża waħda minn dawn l-istrutturi eżatti ta' eżempju:

Il-mutazzjonijiet l-oħra kollha m'għandhomx body tat-talba. Xorta jeħtieġu eżattament header wieħed Idempotency-Key.

Eżempji addizzjonali ta' suċċess

Listi vojta huma validi u jagħmlu l-envelopes fl-ogħla livell ċari:

{"items":[],"metricsWindow":{"from":"2026-05-26T00:00:00.000Z","to":"2026-08-24T00:00:00.000Z","sessionLimit":10000,"sessionsIncluded":0,"totalsCapped":false},"connectorLookups":{"formats":[],"types":[],"powerTypes":[]}}

{"items":[],"pageTotals":{"sessions":0,"energyWh":0,"durationSeconds":0,"costs":[]},"page":{"limit":50,"nextCursor":null},"range":{"from":"2026-07-01T00:00:00.000Z","to":"2026-08-01T00:00:00.000Z","toExclusive":true}}

{"status":"Accepted"}

{"status":"Accepted","connectorResults":[{"connectorId":1,"status":"Accepted"}]}

{"sent":true,"format":"csv","rowCount":12,"range":{"from":"2026-07-01T00:00:00.000Z","to":"2026-08-01T00:00:00.000Z"}}

{"items":[],"invitations":[],"chargers":[],"page":{"nextCursor":null,"memberNextCursor":null,"invitationNextCursor":null,"limit":50}}

Għar-risponsi li fihom oġġetti, daħħal id-DTO bl-isem eżatt mis-sezzjonijiet ta' hawn fuq fl-envelope elenkat f'Referenza tal-endpoints; pereżempju, il-ħolqien tat-tariffa huwa { "tariff": Tariff }, il-ħolqien tal-profil huwa { "profile": ChargingProfile } u l-ħolqien tal-utent huwa { "user": User }.