Terminals

6 endpoints

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

Terminals auflisten

get/v1/terminals

Gekoppelte PAX IM30.

Réponse 200TerminalList

Nom	Type	Description
`object`obligatoire	"list"
`data`obligatoire	Terminal[]
`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/terminals \n  -H "Authorization: Bearer lh_test_…"

Réponse 200

{
  "object": "list",
  "data": [
    {
      "id": "trm_6b0c2d8e1f3a5b7c",
      "object": "terminal",
      "name": "string",
      "model": "string",
      "location_id": "string",
      "integration_id": "string",
      "external_terminal_id": "string",
      "paired": true,
      "online": true,
      "app_version": "string",
      "last_seen_at": "2026-10-25T08:30:00.000Z",
      "created_at": "string"
    }
  ],
  "has_more": true
}

Terminal anlegen

post/v1/terminals

Neues PAX IM30 für einen Standort. Antwort enthält den Wartungs-PIN (nur einmal sichtbar).

Paramètres

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

Requête

Nom	Type	Description
`name`facultatif	string
`location_id`obligatoire	string
`integration_id`facultatif	string \| null
`external_terminal_id`facultatif	string \| null
`maintenance_pin`facultatif	string

Réponse 201Terminal

Nom	Type	Description
`id`obligatoire	string	ID mit Präfix «trm_»
`object`obligatoire	"terminal"
`name`obligatoire	string
`model`obligatoire	string
`location_id`obligatoire	string
`integration_id`obligatoire	string \| null
`external_terminal_id`obligatoire	string \| null	Terminal-ID bei Freika
`paired`obligatoire	boolean
`online`obligatoire	boolean
`app_version`obligatoire	string \| null
`last_seen_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/terminals \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"name":"PAX IM30","location_id":"string","integration_id":"string","external_terminal_id":"string","maintenance_pin":"string"}'

Réponse 201

{
  "id": "trm_6b0c2d8e1f3a5b7c",
  "object": "terminal",
  "name": "string",
  "model": "string",
  "location_id": "string",
  "integration_id": "string",
  "external_terminal_id": "string",
  "paired": true,
  "online": true,
  "app_version": "string",
  "last_seen_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Freika-Terminals

get/v1/terminals/available

Terminals im verbundenen Freika-Konto zur Auswahl beim Koppeln.

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 GET https://api.ladehase.com/v1/terminals/available \n  -H "Authorization: Bearer lh_test_…"

Réponse 200

{}

Terminal ändern

patch/v1/terminals/{id}

Name, Standort, Freika-Terminal, Wartungs-PIN.

Paramètres

Nom	Emplacement	Type
`id`obligatoire	Chemin	string

Requête

Nom	Type	Description
`name`facultatif	string
`location_id`facultatif	string
`integration_id`facultatif	string \| null
`external_terminal_id`facultatif	string \| null
`maintenance_pin`facultatif	string

Réponse 200Terminal

Nom	Type	Description
`id`obligatoire	string	ID mit Präfix «trm_»
`object`obligatoire	"terminal"
`name`obligatoire	string
`model`obligatoire	string
`location_id`obligatoire	string
`integration_id`obligatoire	string \| null
`external_terminal_id`obligatoire	string \| null	Terminal-ID bei Freika
`paired`obligatoire	boolean
`online`obligatoire	boolean
`app_version`obligatoire	string \| null
`last_seen_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 PATCH https://api.ladehase.com/v1/terminals/{id} \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"name":"PAX IM30","location_id":"string","integration_id":"string","external_terminal_id":"string","maintenance_pin":"string"}'

Réponse 200

{
  "id": "trm_6b0c2d8e1f3a5b7c",
  "object": "terminal",
  "name": "string",
  "model": "string",
  "location_id": "string",
  "integration_id": "string",
  "external_terminal_id": "string",
  "paired": true,
  "online": true,
  "app_version": "string",
  "last_seen_at": "2026-10-25T08:30:00.000Z",
  "created_at": "string"
}

Terminal entfernen

delete/v1/terminals/{id}

Die App muss danach neu gekoppelt werden.

Paramètres

Nom	Emplacement	Type
`id`obligatoire	Chemin	string

Réponse 200Deleted

Nom	Type	Description
`id`obligatoire	string
`object`obligatoire	string
`deleted`obligatoire	true

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/terminals/{id} \n  -H "Authorization: Bearer lh_test_…"

Réponse 200

{
  "id": "string",
  "object": "string",
  "deleted": true
}

Kopplungscode

post/v1/terminals/{id}/pairing_codes

Code und QR-Inhalt zum Koppeln der Terminal-App (15 Minuten gültig).

Paramètres

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

Réponse 201Object

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/terminals/{id}/pairing_codes \n  -H "Authorization: Bearer lh_test_…"

Réponse 201

{}