Register 9 · Hilfe · Blatt 83 · Archiv

Schnittstelle API v0

Alle Aufrufe unter /api/v0 antworten seit dem 30. Juni 2023 mit 410. Zugriffe laufen über /api/v1 mit Bearer-Token.

Geschlossen am 30.06.2023

Die API v0 erschien am 10. September 2019. Sie lieferte Monatslisten als JSON, lesend, mit einem Zugangsschlüssel als Parameter in der Adresse. Mit der API v1 vom 8. Februar 2022 galt sie als veraltet.

Verlauf

• 8. Februar 2022: v0 gilt als veraltet, die API v1 startet.
• 5. Dezember 2022: Abschalttermin 30. Juni 2023, Header Sunset in jeder Antwort.
• 2. Mai 2023: Jede Antwort enthält das Feld hinweis mit dem Termin.
• 30. Juni 2023: Abschaltung. Alle Schlüssel sind gelöscht.

Was ein Aufruf heute liefert

Jede Anfrage unter /api/v0 endet mit dem Status 410. Skripte sollten den Status 410 abfangen. Wiederholen hilft nicht.

HTTP/1.1 410 Gone
Content-Type: application/json

{
  "code": "gone",
  "message": "Die API v0 wurde am 30. Juni 2023 abgeschaltet. Bitte verwenden Sie /api/v1."
}

Umstellung auf v1

Legen Sie im Bereich Konto ein API-Token an. Es wird nur einmal angezeigt und beginnt mit lwk_. Schicken Sie es im Header Authorization mit. Pro Konto sind 10 Tokens möglich, pro Token gelten 120 Anfragen pro Minute.

# v0 (abgeschaltet)
GET /api/v0/monatsliste?monat=2019-09&schluessel=ABC123

# v1
GET /api/v1/zeiten?from=2019-09-01&to=2019-09-30
Authorization: Bearer lwk_...

Die Antwort der v1 ist ein Objekt mit data und next_cursor. Die v0 lieferte eine Liste ohne Rahmen. Bei mehr als 50 Einträgen holen Sie die nächsten Seiten mit cursor, höchstens 200 Einträge pro Antwort. Anfragen mit POST sollten einen Idempotency-Key tragen, damit eine Wiederholung keinen zweiten Eintrag anlegt.

Zurück zum Archiv