carregados.com.br

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Internal charging-location name."
    },
    "displayName": {
      "description": "Public display name.",
      "type": [
        "string",
        "null"
      ]
    },
    "address": {
      "type": "string",
      "minLength": 1,
      "description": "Street address or public location description."
    },
    "description": {
      "description": "Public station description.",
      "type": [
        "string",
        "null"
      ]
    },
    "hours": {
      "description": "Opening hours text.",
      "type": [
        "string",
        "null"
      ]
    },
    "formattedPhoneNumber": {
      "description": "Formatted public phone number.",
      "type": [
        "string",
        "null"
      ]
    },
    "phoneNumber": {
      "description": "Raw phone number.",
      "type": [
        "string",
        "null"
      ]
    },
    "city": {
      "description": "City value.",
      "type": [
        "string",
        "null"
      ]
    },
    "state": {
      "description": "State value, for example \"parana (pr)\".",
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "description": "Country value.",
      "type": [
        "string",
        "null"
      ]
    },
    "displayCity": {
      "description": "Public display city.",
      "type": [
        "string",
        "null"
      ]
    },
    "displayState": {
      "description": "Public display state.",
      "type": [
        "string",
        "null"
      ]
    },
    "displayCountry": {
      "description": "Public display country.",
      "type": [
        "string",
        "null"
      ]
    },
    "priceKwh": {
      "description": "Charging price per kWh in BRL.",
      "type": [
        "number",
        "null"
      ]
    },
    "priceKwhComment": {
      "description": "Comment explaining the kWh price.",
      "type": [
        "string",
        "null"
      ]
    },
    "activationPrice": {
      "description": "Activation or session fee in BRL.",
      "type": [
        "number",
        "null"
      ]
    },
    "activationPriceComment": {
      "description": "Comment explaining the activation/session fee.",
      "type": [
        "string",
        "null"
      ]
    },
    "costDescription": {
      "description": "Freeform pricing/cost description.",
      "type": [
        "string",
        "null"
      ]
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether chargers are currently enabled."
    },
    "open247": {
      "type": "boolean",
      "description": "Whether the station is open 24/7."
    },
    "comingSoon": {
      "description": "Whether the station is marked as coming soon.",
      "type": "boolean"
    },
    "underRepair": {
      "description": "Whether the station is marked as under repair.",
      "type": "boolean"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Station latitude for authenticated creation."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Station longitude for authenticated creation."
    },
    "icon_type": {
      "description": "Station icon/category type.",
      "type": [
        "string",
        "null"
      ]
    },
    "restricted": {
      "type": "boolean",
      "description": "Whether access is restricted."
    },
    "isFree": {
      "type": "boolean",
      "description": "Whether charging is free."
    },
    "stations": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Existing charger id when updating an owned/imported location.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "networkId": {
            "description": "Optional Carregados charging network id.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "kilowatts": {
            "description": "Optional charger power in kW.",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "outlets": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "description": "Existing outlet id when updating an owned/imported location.",
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                "connector": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Required connector id, for example 20 for CCS2 or 7 for Tipo 2."
                },
                "connectorName": {
                  "description": "Optional connector display name, for example CCS2.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "connector"
              ],
              "additionalProperties": {}
            },
            "description": "Connector outlets for this charger."
          }
        },
        "required": [
          "outlets"
        ],
        "additionalProperties": {}
      },
      "description": "Chargers at the location. Each charger needs at least one outlet with a connector id."
    },
    "idempotencyKey": {
      "description": "Optional stable key for safely retrying the same create request for 24 hours.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:/+=-]{8,200}$"
    },
    "confirmed": {
      "description": "Must be true only after the user explicitly confirms this action.",
      "type": "boolean"
    }
  },
  "required": [
    "name",
    "address",
    "enabled",
    "open247",
    "latitude",
    "longitude",
    "restricted",
    "isFree",
    "stations"
  ]
}