QR-Codes

6 endpoints

The endpoint descriptions come directly from the API and are in German.

QR-Codes auflisten

get/v1/codes

Statische QR-Codes mit URL und Anzahl Scans.

Response 200CodeList

Name	Type	Description
`object`required	"list"
`data`required	Code[]
`has_more`required	boolean

Possible errors

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

Example

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

Response 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).

Parameters

Name	In	Type
`idempotency-key`optionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Header	string

Request

Name	Type	Description
`target`required	"connector" \| "location"
`connector_id`optional	string
`location_id`optional	string
`label`optional	string

Response 201Code

Name	Type	Description
`id`required	string	ID mit Präfix «qr_»
`object`required	"code"
`code`required	string	Kurzcode auf dem Schild
`target`required	"connector" \| "location"
`connector_id`required	string \| null
`location_id`required	string \| null
`label`required	string \| null
`url`required	string
`display_url`required	string
`scans`required	integer
`disabled`required	boolean
`created_at`required	string

Possible errors

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

Example

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

Response 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.

Parameters

Name	In	Type
`id`required	Path	string

Response 200Code

Name	Type	Description
`id`required	string	ID mit Präfix «qr_»
`object`required	"code"
`code`required	string	Kurzcode auf dem Schild
`target`required	"connector" \| "location"
`connector_id`required	string \| null
`location_id`required	string \| null
`label`required	string \| null
`url`required	string
`display_url`required	string
`scans`required	integer
`disabled`required	boolean
`created_at`required	string

Possible errors

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

Example

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

Response 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.

Parameters

Name	In	Type
`id`required	Path	string

Request

Name	Type	Description
`label`optional	string
`disabled`optional	boolean

Response 200Code

Name	Type	Description
`id`required	string	ID mit Präfix «qr_»
`object`required	"code"
`code`required	string	Kurzcode auf dem Schild
`target`required	"connector" \| "location"
`connector_id`required	string \| null
`location_id`required	string \| null
`label`required	string \| null
`url`required	string
`display_url`required	string
`scans`required	integer
`disabled`required	boolean
`created_at`required	string

Possible errors

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

Example

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

Response 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.

Parameters

Name	In	Type
`id`required	Path	string

Possible errors

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

Example

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.

Parameters

Name	In	Type
`id`required	Path	string

Possible errors

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

Example

curl -X GET https://api.ladehase.com/v1/codes/{id}/qr.png \n  -H "Authorization: Bearer lh_test_…"