Beispiel · keine echte Abfrage
← Zur Startseite Beispielhafte Darstellung · keine echte Abfrage

So bindet Ihre Software den Rechtsbestand von Junoda ein

API-Anbindung Verständlich erklärt – auch ohne Technik-Hintergrund

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.

Beispiel

So läuft eine Anfrage ab

1

Ihre Software stellt eine Frage

Ein:e Nutzer:in tippt eine ganz normale Frage – wie in einer Suchmaschine, nicht in einer Fachsprache.

„Wann ist die Miete wegen Schimmel gemindert?"
2

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.

1
Bei einem Mangel, der die Tauglichkeit der Mietsache aufhebt, ist der Mieter für diese Zeit von der Entrichtung der Miete befreit.
2
§ 536 Abs. 1 BGB§ 536c BGB
3
Datenschutz-Modus: an – bleibt vertraulich
  1. 1Die Antwort in normaler Sprache – kein Fachjargon.
  2. 2Die Fundstellen, auf die sich die Antwort stützt – jede Angabe im Original nachprüfbar.
  3. 3Ob vertrauliche Inhalte Junodas eigene Server verlassen (hier: nein).
3

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.

ihre-software.de/rechtsauskunft
Wann ist die Miete wegen Schimmel gemindert?
Bei einem Mangel, der die Tauglichkeit der Mietsache aufhebt, ist der Mieter für diese Zeit von der Entrichtung der Miete befreit (§ 536 Abs. 1 BGB, § 536c BGB).
Für Ihre Entwickler:innen (technische Details)
bash
curl https://api.junoda.de/api/v1/antworten \
  -H "Authorization: Bearer $JUNODA_SCHLUESSEL" \
  -d '{"frage": "Wann ist die Miete wegen Schimmel gemindert?"}'
Antwort (JSON)
{
  "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

Beispiel

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.

Verweist selbst auf (aktiv)
§ 536a BGBSchadens- und Aufwendungsersatz des Mieters
§ 536 BGB
Wird zitiert von (passiv)
BGH · VIII ZR 138/11Urteil vom 15.11.2011, in den Gründen zitiert
Für Ihre Entwickler:innen (technische Details)
bash · nur aktiv
curl "https://api.junoda.de/api/v1/normen/bgb/536/verweise?richtung=aktiv" \
  -H "Authorization: Bearer $JUNODA_SCHLUESSEL"
bash · nur passiv (Abkürzung für richtung=passiv)
curl https://api.junoda.de/api/v1/normen/bgb/536/zitiert-von \
  -H "Authorization: Bearer $JUNODA_SCHLUESSEL"
Antwort (JSON, gekürzt)
{
  "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.

Beispiel

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.

1
Erkannte Vorschriften§ 536 Abs. 1 BGB
2
Erkannte EntscheidungenBGH, 6.4.2017 – 3 StR 5/17
  1. 1Vorschriften werden bis auf Absatz/Satz genau aufgelöst – nicht nur „gefunden", sondern als Gesetz, Paragraf und Absatz einzeln nutzbar.
  2. 2Ebenso Gerichtsentscheidungen, samt Gericht, Datum und Aktenzeichen als eigene Felder.
Für Ihre Entwickler:innen (technische Details)
bash
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." }'
Antwort (JSON)
{
  "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.

Der Unterschied

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.

Selbst aufbauen
  • Gesetzestexte und Änderungen von Hand nachpflegen
  • Rechtsprechung selbst sammeln und verschlagworten
  • Zitate von Hand prüfen und verlinken
  • Ein eigenes Datenschutzkonzept entwickeln
Mit der Junoda-API
  • 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
Interesse?
Wir richten die Anbindung gemeinsam mit Ihrem Team ein.