Verbindungen

8 endpoints

Les descriptions des endpoints proviennent directement de l'API et sont en allemand.

Verbindungen auflisten

get/v1/integrations

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

Réponse 200IntegrationList

Nom	Type	Description
`object`obligatoire	"list"
`data`obligatoire	Integration[]
`has_more`obligatoire	boolean

Erreurs possibles

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

Exemple

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

Réponse 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.

Paramètres

Nom	Emplacement	Type
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Requête

Nom	Type	Description
`userName`obligatoire	string
`password`obligatoire	string

Réponse 201Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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.

Paramètres

Nom	Emplacement	Type
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Requête

Nom	Type	Description
`instance`obligatoire	string
`apiKey`obligatoire	string

Réponse 201Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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.

Paramètres

Nom	Emplacement	Type
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Requête

Nom	Type	Description
`apiKey`obligatoire	string

Réponse 201Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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_).

Paramètres

Nom	Emplacement	Type
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Réponse 201Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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.

Paramètres

Nom	Emplacement	Type
`id`obligatoire	Chemin	string
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Réponse 200Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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.

Paramètres

Nom	Emplacement	Type
`id`obligatoire	Chemin	string
`idempotency-key`facultatifWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	En-tête	string

Réponse 200Object

Erreurs possibles

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

Exemple

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

Réponse 200

{}

Verbindung trennen

delete/v1/integrations/{id}

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

Paramètres

Nom	Emplacement	Type
`id`obligatoire	Chemin	string

Réponse 200Integration

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

Erreurs possibles

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

Exemple

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

Réponse 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"
}