QR-Codes

6 endpoint

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

QR-Codes auflisten

get/v1/codes

Statische QR-Codes mit URL und Anzahl Scans.

Risposta 200CodeList

Nome	Tipo	Descrizione
`object`obbligatorio	"list"
`data`obbligatorio	Code[]
`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/codes \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{
  "object": "list",
  "data": [
    {
      "id": "qr_3c9a1e7b0d2f4a6c",
      "object": "code",
      "code": "k7m2p9x",
      "target": "connector",
      "connector_id": "string",
      "location_id": "string",
      "label": "string",
      "url": "https://hof-meier.ladehase.com/k7m2p9x",
      "display_url": "string",
      "scans": 0,
      "disabled": true,
      "created_at": "string"
    }
  ],
  "has_more": true
}

QR-Code anlegen

post/v1/codes

Für einen Ladepunkt oder einen ganzen Standort (Auswahl auf der Bezahlseite).

Parametri

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

Richiesta

Nome	Tipo	Descrizione
`target`obbligatorio	"connector" \| "location"
`connector_id`facoltativo	string
`location_id`facoltativo	string
`label`facoltativo	string

Risposta 201Code

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «qr_»
`object`obbligatorio	"code"
`code`obbligatorio	string	Kurzcode auf dem Schild
`target`obbligatorio	"connector" \| "location"
`connector_id`obbligatorio	string \| null
`location_id`obbligatorio	string \| null
`label`obbligatorio	string \| null
`url`obbligatorio	string
`display_url`obbligatorio	string
`scans`obbligatorio	integer
`disabled`obbligatorio	boolean
`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/codes \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"target":"connector","connector_id":"string","location_id":"string","label":"string"}'

Risposta 201

{
  "id": "qr_3c9a1e7b0d2f4a6c",
  "object": "code",
  "code": "k7m2p9x",
  "target": "connector",
  "connector_id": "string",
  "location_id": "string",
  "label": "string",
  "url": "https://hof-meier.ladehase.com/k7m2p9x",
  "display_url": "string",
  "scans": 0,
  "disabled": true,
  "created_at": "string"
}

QR-Code abrufen

get/v1/codes/{id}

Ein QR-Code.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Risposta 200Code

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «qr_»
`object`obbligatorio	"code"
`code`obbligatorio	string	Kurzcode auf dem Schild
`target`obbligatorio	"connector" \| "location"
`connector_id`obbligatorio	string \| null
`location_id`obbligatorio	string \| null
`label`obbligatorio	string \| null
`url`obbligatorio	string
`display_url`obbligatorio	string
`scans`obbligatorio	integer
`disabled`obbligatorio	boolean
`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 GET https://api.ladehase.com/v1/codes/{id} \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{
  "id": "qr_3c9a1e7b0d2f4a6c",
  "object": "code",
  "code": "k7m2p9x",
  "target": "connector",
  "connector_id": "string",
  "location_id": "string",
  "label": "string",
  "url": "https://hof-meier.ladehase.com/k7m2p9x",
  "display_url": "string",
  "scans": 0,
  "disabled": true,
  "created_at": "string"
}

QR-Code ändern

patch/v1/codes/{id}

Bezeichnung ändern oder deaktivieren.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Richiesta

Nome	Tipo	Descrizione
`label`facoltativo	string
`disabled`facoltativo	boolean

Risposta 200Code

Nome	Tipo	Descrizione
`id`obbligatorio	string	ID mit Präfix «qr_»
`object`obbligatorio	"code"
`code`obbligatorio	string	Kurzcode auf dem Schild
`target`obbligatorio	"connector" \| "location"
`connector_id`obbligatorio	string \| null
`location_id`obbligatorio	string \| null
`label`obbligatorio	string \| null
`url`obbligatorio	string
`display_url`obbligatorio	string
`scans`obbligatorio	integer
`disabled`obbligatorio	boolean
`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 PATCH https://api.ladehase.com/v1/codes/{id} \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"label":"string","disabled":true}'

Risposta 200

{
  "id": "qr_3c9a1e7b0d2f4a6c",
  "object": "code",
  "code": "k7m2p9x",
  "target": "connector",
  "connector_id": "string",
  "location_id": "string",
  "label": "string",
  "url": "https://hof-meier.ladehase.com/k7m2p9x",
  "display_url": "string",
  "scans": 0,
  "disabled": true,
  "created_at": "string"
}

QR-Code als SVG

get/v1/codes/{id}/qr.svg

Mit Bildmarke in der Mitte.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	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 GET https://api.ladehase.com/v1/codes/{id}/qr.svg \n  -H "Authorization: Bearer lh_test_…"

QR-Code als PNG

get/v1/codes/{id}/qr.png

1024 × 1024 Pixel.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	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 GET https://api.ladehase.com/v1/codes/{id}/qr.png \n  -H "Authorization: Bearer lh_test_…"