API-Zugang
Gesetze und Entscheidungen sind maschinenlesbar abrufbar — frei, ohne Schlüssel. Bei Spitzenlast werden registrierte Zugänge zuerst bedient.
Was die Schnittstelle liefert
Die JSON-API unter /v1 gibt dieselben Inhalte aus wie die Seiten:
konsolidierte Bundesgesetze und Verordnungen mit ihren früheren Fassungen und
Entscheidungen deutscher Gerichte. Jede Antwort nennt ihre Quelle und ihren
Stand. Was nicht im Bestand ist, wird als fehlend gemeldet und nicht geraten.
Endpunkte, Felder und Beispiele: Developer-API.
Was bei Spitzenlast passiert
Es gibt Zeiten, in denen mehr Anfragen ankommen, als gleichzeitig beantwortet werden können. Dann beantwortet die Seite einen Teil der Anfragen vorübergehend mit einer Absage (HTTP 503) und die API mit einer Grenzmeldung (HTTP 429). Das ist keine Störung, sondern die Reihenfolge: zuerst bedient werden registrierte Zugänge — Programme wie Menschen.
Der anonyme Abruf bleibt offen und bleibt kostenlos. Er ist nur der erste, der bei Andrang nachgibt, und seine Abrufgrenze je Minute liegt niedriger als die eines registrierten Zugangs. Wer regelmäßig oder in größerem Umfang abruft, fährt registriert besser.
Registrierung
Die Registrierung ist kostenlos — vorerst. Heute wird nichts abgerechnet, und es gibt noch keine Selbstbedienung: die Warteliste ist der Weg hinein. Ein Eintrag nennt uns Name, Adresse und wofür der Zugang gedacht ist; Schlüssel werden daraufhin vergeben. Sollte der Zugang später etwas kosten, sagen wir es vorher und nicht rückwirkend.
- Höhere AbrufgrenzeMehr Anfragen je Minute als der anonyme Zugang.
- Vorrang bei SpitzenlastRegistrierte Zugänge werden zuerst bedient, wenn es eng wird.
- AnsprechbarEin registrierter Zugang hat eine Adresse, an die wir uns bei Änderungen wenden können.
Der Eintrag geht auf dieselbe Warteliste wie die Anfrage nach einem Nutzerkonto. Kein Newsletter; die Adresse dient allein dieser einen Sache.
Was ohne Registrierung bleibt
Alle Inhalte bleiben frei lesbar und frei verlinkbar, im Browser wie über
/v1. Es gibt keine Bezahlschranke vor einem Gesetz, einer Norm oder
einer Entscheidung, und es ist keine geplant. Was die Registrierung ändert, ist
allein die Reihenfolge und die Abrufgrenze, nicht der Zugang zum Inhalt.
Bedingungen für den maschinellen Abruf: Nutzungsbedingungen. Lizenz und Herkunft je Kanal: Lizenz.