Verbindungen

8 endpoint

Le descrizioni degli endpoint provengono direttamente dall'API e sono in tedesco.

Verbindungen auflisten

get/v1/integrations

Verbundene Hersteller (Easee) und Zahlungskonten (zahls.ch, Freika). Zugangsdaten werden nie ausgegeben.

Risposta 200IntegrationList

Nome	Tipo	Descrizione
`object`obbligatorio	"list"
`data`obbligatorio	Integration[]
`has_more`obbligatorio	boolean

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X GET https://api.ladehase.com/v1/integrations \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{
  "object": "list",
  "data": [
    {
      "id": "int_4a7c2b9d0e1f3a5c",
      "object": "integration",
      "kind": "easee",
      "livemode": true,
      "name": "string",
      "status": "pending",
      "public_info": {},
      "webhook_url": "string",
      "last_error": "string",
      "last_checked_at": "2026-10-25T08:30:00.000Z",
      "last_synced_at": "2026-10-25T08:30:00.000Z",
      "created_at": "string"
    }
  ],
  "has_more": true
}

Easee verbinden

post/v1/integrations/easee

Meldet sich einmal mit dem Easee-Login an. Ladehase speichert nur die Tokens (verschlüsselt), nie das Passwort, und importiert sofort alle Charger. Neue Charger sind zuerst deaktiviert.

Parametri

Nome	Posizione	Tipo
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Richiesta

Nome	Tipo	Descrizione
`userName`obbligatorio	string
`password`obbligatorio	string

Risposta 201Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/easee \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"userName":"string","password":"string"}'

Risposta 201

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

zahls.ch-Konto verbinden

post/v1/integrations/zahls

Verbindet das eigene zahls.ch-Konto mit Instanzname und API-Schlüssel. Das Geld fliesst direkt auf dieses Konto.

Parametri

Nome	Posizione	Tipo
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Richiesta

Nome	Tipo	Descrizione
`instance`obbligatorio	string
`apiKey`obbligatorio	string

Risposta 201Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/zahls \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"instance":"string","apiKey":"string"}'

Risposta 201

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Freika-Konto verbinden

post/v1/integrations/freika

Verbindet das eigene Freika-Konto mit einem API-Schlüssel (Rechte «schreiben» und «Terminals»). Nötig für das PAX IM30.

Parametri

Nome	Posizione	Tipo
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Richiesta

Nome	Tipo	Descrizione
`apiKey`obbligatorio	string

Risposta 201Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/freika \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"apiKey":"string"}'

Risposta 201

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Testgeräte anlegen

post/v1/integrations/test

Legt simulierte Ladepunkte und Testzahlungen an. Ideal zum Ausprobieren ohne Hardware und für automatisierte Tests (Schlüssel lh_test_).

Parametri

Nome	Posizione	Tipo
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Risposta 201Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/test \n  -H "Authorization: Bearer lh_test_…"

Risposta 201

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Verbindung prüfen

post/v1/integrations/{id}/test

Prüft die Zugangsdaten beim Hersteller oder Zahlungspartner und aktualisiert den Status.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Risposta 200Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/{id}/test \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Geräte importieren

post/v1/integrations/{id}/sync

Liest alle Geräte beim Hersteller und legt neue Standorte, Geräte, Ladepunkte und QR-Codes an.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Risposta 200Object

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/integrations/{id}/sync \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{}

Verbindung trennen

delete/v1/integrations/{id}

Löscht die Zugangsdaten. Geräte dieses Herstellers werden deaktiviert.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Risposta 200Integration

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «int_»
`object`obbligatorio	"integration"
`kind`obbligatorio	"easee" \| "zaptec" \| "ocpp" \| "goe" \| "shelly" \| "mock" \| "zahls" \| "freika"	Hersteller oder Zahlungspartner. «mock» = Testmodus.
`livemode`obbligatorio	boolean
`name`obbligatorio	string
`status`obbligatorio	"pending" \| "active" \| "needs_attention" \| "disconnected"
`public_info`obbligatorio	object	Öffentliche Angaben ohne Geheimnisse
`webhook_url`obbligatorio	string \| null	Bei zahls.ch einzutragende Webhook-URL
`last_error`obbligatorio	string \| null
`last_checked_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`last_synced_at`obbligatorio	string \| null	Zeitpunkt (ISO 8601, UTC)
`created_at`obbligatorio	string

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X DELETE https://api.ladehase.com/v1/integrations/{id} \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{
  "id": "int_4a7c2b9d0e1f3a5c",
  "object": "integration",
  "kind": "easee",
  "livemode": true,
  "name": "string",
  "status": "pending",
  "public_info": {},
  "webhook_url": "string",
  "last_error": "string",
  "last_checked_at": "2026-10-25T08:30:00.000Z",
  "last_synced_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}