So bindet Ihre Software den Rechtsbestand von Junoda ein
Eine „API" ist nichts anderes als eine feste Verbindungsleitung zwischen zwei Programmen: Ihre Software schickt eine Frage in normaler Sprache an Junoda, und bekommt in Sekundenbruchteilen eine Antwort samt Beleg zurück – ohne dass jemand von Hand nachschlagen muss. Die drei Schritte unten zeigen, was dabei passiert.
So läuft eine Anfrage ab
Ihre Software stellt eine Frage
Ein:e Nutzer:in tippt eine ganz normale Frage – wie in einer Suchmaschine, nicht in einer Fachsprache.
Junoda antwortet – mit Beleg
Die Antwort kommt nie allein: dazu immer die Gesetze/Urteile, auf die sie sich stützt, und ob vertrauliche Daten überhaupt weitergegeben wurden.
- 1Die Antwort in normaler Sprache – kein Fachjargon.
- 2Die Fundstellen, auf die sich die Antwort stützt – jede Angabe im Original nachprüfbar.
- 3Ob vertrauliche Inhalte Junodas eigene Server verlassen (hier: nein).
Sie zeigen die Antwort in Ihrem Produkt
Die Antwort erscheint dort, wo Ihre Nutzer:innen sie brauchen – im eigenen Chat, Kundenportal oder einer internen Anwendung, im eigenen Erscheinungsbild.
Für Ihre Entwickler:innen (technische Details)
curl https://api.junoda.de/api/v1/antworten \
-H "Authorization: Bearer $JUNODA_SCHLUESSEL" \
-d '{"frage": "Wann ist die Miete wegen Schimmel gemindert?"}'
{
"antwort": "Bei einem Mangel, der die Tauglichkeit der Mietsache aufhebt, ist der Mieter für diese Zeit von der Entrichtung der Miete befreit.",
"fundstellen": ["§ 536 Abs. 1 BGB", "§ 536c BGB"],
"modus": "datenschutz"
}
Vollständige technische Dokumentation mit allen Endpunkten: junoda.de/de/entwickler
Zitier- und Verweisnetz abfragen (beide Richtungen)
Jede Vorschrift kennt zwei Richtungen: was sie selbst zitiert („aktiv") und wer sie zitiert – andere Normen, Gerichtsurteile, Verwaltungsvorschriften („passiv"). Ein einziger Aufruf liefert wahlweise beide oder nur eine Richtung.
Für Ihre Entwickler:innen (technische Details)
curl "https://api.junoda.de/api/v1/normen/bgb/536/verweise?richtung=aktiv" \
-H "Authorization: Bearer $JUNODA_SCHLUESSEL"
curl https://api.junoda.de/api/v1/normen/bgb/536/zitiert-von \
-H "Authorization: Bearer $JUNODA_SCHLUESSEL"
{
"anzahlen": { "aktiv": 2, "passiv": 2 },
"normen": {
"total": 2,
"limit": 20,
"offset": 0,
"items": [
{
"richtung": "aktiv",
"art": "VERWEIS",
"relation": "VERWEIST_AUF",
"randnummer": 2,
"gegenstelle": {
"typ": "NORM",
"kennung": "BGB/536a",
"zitierkennung": "§ 536a BGB",
"titel": "Bürgerliches Gesetzbuch",
"link": "https://junoda.de/de/gesetze/bgb/536a"
}
}
]
},
"entscheidungen": {
"total": 2,
"limit": 20,
"offset": 0,
"items": [
{
"richtung": "passiv",
"art": "VERWEIS",
"relation": "ZITIERT_NORM",
"randnummer": null,
"gegenstelle": {
"typ": "ENTSCHEIDUNG",
"kennung": "VIII ZR 138/11",
"zitierkennung": "VIII ZR 138/11",
"titel": "Anforderungen an die Anzeige eines Mangels",
"gericht": "Bundesgerichtshof",
"datum": "2011-11-15",
"link": "https://junoda.de/de/rechtsprechung/…"
}
}
]
},
"verwaltungsvorschriften": { "total": 0, "limit": 20, "offset": 0, "items": [] }
}
Ohne den Parameter richtung liefert /verweise von sich aus beide Richtungen zusammen (anzahlen.aktiv und anzahlen.passiv zeigen, wie viele es je Richtung gibt); /zitiert-von ist nur eine feste Abkürzung dafür, ausschließlich die passive Richtung zu bekommen. Die Antwort ist nach Gegenstelle gruppiert (normen, entscheidungen, verwaltungsvorschriften), jede Gruppe mit eigenem total. Weitergeblättert wird mit limit und offset; zusammen mit ziel, etwa ?ziel=ENTSCHEIDUNG&offset=20, blättert man nur eine Gruppe weiter. /zitiert-von antwortet als eine flache Seite. Dieselbe Anfrageform gilt auch für Entscheidungen, Verwaltungsvorschriften und beliebige Knoten im Aktengraph.
Zitate in einem Text erkennen
Manchmal reicht es, in einem beliebigen Text – einem Schreiben, einem Vertrag, einer E-Mail – nur herauszufinden, welche Gesetze und Urteile darin vorkommen, ohne dass Junoda dazu selbst eine Antwort formuliert. Genau dafür gibt es einen eigenen, sehr schnellen Aufruf: Text rein, gefundene Fundstellen raus.
- 1Vorschriften werden bis auf Absatz/Satz genau aufgelöst – nicht nur „gefunden", sondern als Gesetz, Paragraf und Absatz einzeln nutzbar.
- 2Ebenso Gerichtsentscheidungen, samt Gericht, Datum und Aktenzeichen als eigene Felder.
Für Ihre Entwickler:innen (technische Details)
curl https://api.junoda.de/api/v1/zitate \
-H "Authorization: Bearer $JUNODA_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{ "text": "Der Anspruch folgt aus § 536 Abs. 1 BGB; vgl. BGH, Urteil vom 6. April 2017 - 3 StR 5/17." }'
{
"normen": [
{ "positionVon": 22, "positionBis": 38, "text": "§ 536 Abs. 1 BGB",
"einheit": "PARAGRAF", "abk": "BGB", "ordnungszahl": "536", "absatz": "1", … }
],
"entscheidungen": [
{ "positionVon": 45, "positionBis": 90, "text": "BGH, Urteil vom 6. April 2017 - 3 StR 5/17",
"gericht": "BGH", "datum": "2017-04-06", "aktenzeichen": "3 StR 5/17", … }
],
"verwaltungsvorschriften": [],
"tarifvertraege": []
}
positionVon/positionBis zählen Zeichen im Originaltext – damit lässt sich die Fundstelle direkt im Text markieren, ohne selbst danach zu suchen.
Was Junoda für Sie übernimmt
Ohne Anbindung müsste Ihr Team all das selbst aufbauen und pflegen. Mit der Junoda-API ist es einmal eingerichtet – und bleibt danach von selbst aktuell.
- Gesetzestexte und Änderungen von Hand nachpflegen
- Rechtsprechung selbst sammeln und verschlagworten
- Zitate von Hand prüfen und verlinken
- Ein eigenes Datenschutzkonzept entwickeln
- Der Bestand hält sich automatisch aktuell
- Jede Antwort kommt mit nachprüfbarer Fundstelle
- Datenschutz-Modus lässt sich pro Anfrage zuschalten
- Ein Schlüssel genügt für die ganze Kanzlei/Firma