JSON-API

Lesender Maschinenzugang zur freigegebenen Terminologie unter /api/v1.

Für die Einbindung in andere Systeme steht eine lesende JSON-API bereit. Sie liefert ausschließlich freigegebene Einträge — dieselben, die auch die Website zeigt. Schreibende Zugriffe gibt es nicht.

Endpunkte

Endpunkt	Liefert
`GET /api/v1/search?q=&source=&target=&mode=`	Suche, seitenweise. `mode` ist `normal`, `fuzzy` oder `fulltext`.
`GET /api/v1/entries/{id}`	Einen Begriff vollständig: alle Sprachen, Synonyme, Attribute.
`GET /api/v1/suggest?q=`	Vorschläge zur Eingabe, für Autovervollständigung.
`GET /api/v1/languages`	Die verfügbaren Sprachen mit ihren Codes.
`GET /api/v1/openapi.yaml`	Die vollständige Schnittstellenbeschreibung (OpenAPI 3).

Antworten folgen dem üblichen Aufbau mit data, meta und links; Listen sind paginiert.

Adressierung über die ID

Anders als die Website spricht die API einen Begriff über seine numerische ID an, nicht über die sprechende Adresse. Die ID ändert sich nie — die API ist ein Vertrag für Maschinen, keine lesbare Adresse.

Ein nicht freigegebener Begriff antwortet mit 404, nicht mit einem leeren Datensatz: Über die API ist nicht erkennbar, ob es einen unveröffentlichten Eintrag gibt.

Nutzungsgrenzen

Die API ist mengenmäßig begrenzt (standardmäßig 60 Anfragen pro Minute und IP-Adresse). Die verbleibende Anzahl steht in den X-RateLimit-*-Kopfzeilen jeder Antwort. Für den Zugriff aus dem Browser einer anderen Domain muss diese Domain freigeschaltet sein.