Webservice/API-Zugriff

Allgemeines

Viele Daten dieser Website können direkt über eine HTTP-Schnittstelle abgefragt werden. Bisher wird die Suche nach Wörtern, Teilwörtern und nach ähnlich geschriebenen Wörtern unterstützt. Noch nicht unterstützt wird die Wikipedia/Wiktionary-Suche.

Hinweis: wer die API über reines Testen hinaus benutzt, sollte sich bitte vorher bei feedback at openthesaurus.de melden. Nur so können wir rechtzeitig alle Nutzer kontaktieren, um zum Beispiel über mögliche Änderungen am Ausgabeformat zu informieren.

Suchanfrage für XML

Mit der folgenden HTTP-Anfrage via GET können alle Synonymgruppen, die das Wort test beinhalten, abgefragt werden:

http://www.openthesaurus.de/synonyme/
search?q=test&format=text/xml

Kommt im Suchwort ein Sonderzeichen vor, muss es mit UTF-8 URL-kodiert werden (z.B. wird hören zu h%C3%B6ren).

Ergebnis

Das Ergebnis der Anfrage ist eine XML-Datei mit folgendem Format:

<matches>
  <metaData>
    <apiVersion content="0.1.3"/>
    <warning content="WARNING -- this XML format may be extended without warning"/>
    <copyright content="Copyright (C) 2011 Daniel Naber (www.danielnaber.de)"/>
    <license content="GNU LESSER GENERAL PUBLIC LICENSE Version 2.1"/>
    <source content="http://www.openthesaurus.de"/>
    <date content="Sat Mar 06 22:47:25 CET 2011"/>
  </metaData>
  <synset id="1234">
    <categories>
      <category name="Name der Kategorie"/>
    </categories>
    <term term="Bedeutung 1, Wort 1"/>
    <term term="Bedeutung 1, Wort 2"/>
  </synset>
  <synset id="2345">
    <categories/>
    <term term="Bedeutung 2, Wort 1"/>
  </synset>
</matches>

Suchanfrage für JSON

Statt text/xml kann application/json angegeben werden, um das Ergebnis im JSON-Format zu erhalten.

http://www.openthesaurus.de/synonyme/
search?q=test&format=application/json

Suchanfrage für JSONP

Mit der Übergabe einer Callback-Methode kann der JSON-Code als Parameter einer Funktion übergeben werden. Eine Beispiel-Seite.

http://www.openthesaurus.de/synonyme/
search?q=test&format=application/json&callback=myCallback

Optionen

Bekannte Probleme

Umlaute werden bei der Suche wie ihre nicht-Umlaute behandelt, so findet tur auch den Eintrag zu Tür und umgekehrt.

Anfrage-Limitierung

Bei mehr als 60 Anfragen pro Minute von der gleichen IP-Adresse folgt eine Fehlermeldung (HTTP-Code 500). Wer mehr Anfragen stellen möchte, kann uns kontaktieren und um eine Erhöhung des Limits bitten. Zusätzlich zur direkten Abfrage stehen weiterhin Downloads der Datenbank zur Verfügung. Statt Massenabfragen über die API sollte dieser Download genutzt werden.