Trickregister API

Die Trickregister API ist eine öffentliche Schnittstelle, mit der sich Einträge aus dem offiziellen Trickregister per Freitextsuche oder direkter Registernummer abfragen lassen.

Basis-URL

https://trickregister.de/api/api.php

GET /api.php?q=...

Suche nach dem wahrscheinlichsten Trick anhand einer beliebigen Textphrase.

Parameter	Typ	Beschreibung	Beispiel
`q`	string	Suchtext (UTF-8-kodiert)	Brille hochschieben statt Hand heben
`limit`	integer	Anzahl der zurückgegebenen Ergebnisse (1 – 50, Standard = 10)	10
`only_code`	0 / 1	Wenn 1, wird nur die Code-Nummer des besten Treffers ausgegeben	1

Beispiel

GET /api/api.php?q=Brille%20hochschieben%20statt%20Hand%20heben&limit=10

Antwort

{
  "query": "Brille hochschieben statt Hand heben",
  "best": {
    "code": "7.3.2",
    "title": "Brille hochschieben statt Hand heben",
    "score": 1.0,
    "percent": 100
  },
  "results": [
    {"code":"7.3.2","title":"Brille hochschieben statt Hand heben","score":1.0,"percent":100},
    {"code":"8.1.5","title":"Blickkontakt statt Handzeichen","score":0.73,"percent":68}
  ],
  "took_ms": 7
}

Nur Code

GET /api/api.php?q=brille%20hochschieben&only_code=1

Antwort

{ "code": "7.3.2" }

GET /api.php?code=...

Direktabruf eines bestimmten Tricks über seine Registernummer.

Beispiel

GET /api/api.php?code=1.2.3.5

Antwort

{
  "code": "1.2.3.5",
  "title": "Eine kleine Pause als Machtmittel"
}

Antwort-Schema

{
  "query": string,
  "best": { "code": string, "title": string, "score": number, "percent": number } | null,
  "results": [ { "code": string, "title": string, "score": number, "percent": number } ],
  "took_ms": number
}

Fehlercodes

Status	Beispiel-Body	Beschreibung
400	{"error":"missing_query"}	Parameter `q` fehlt
404	{"error":"not_found"}	Kein Eintrag zur angegebenen `code`-Nummer
500	{"error":"internal"}	Interner Serverfehler (z. B. ungültige Eingabe oder DB-Fehler)

Limits & CORS

Cross-Origin-Anfragen erlaubt: Access-Control-Allow-Origin: *
Empfohlenes Nutzungslimit: max. 60 Anfragen pro Minute und IP
Antworten werden in UTF-8 kodiert

Lizenz & Attribution

Die Inhalte des Trickregisters sind urheberrechtlich geschützt.
Nichtkommerzielle Nutzung der API ist erlaubt, sofern die Quelle „Trickregister.de“ und die jeweilige Registernummer angegeben werden.
Für kommerzielle Anwendungen ist eine separate Freigabe erforderlich.

Beispiele

curl

curl -s 'https://trickregister.de/api/api.php?q=Handy%20au%C3%9Ferhalb%20des%20Raums' | jq .

JavaScript (Browser)

<script>
(async()=>{
  const url = '/api/api.php?q=' + encodeURIComponent('Brille hochschieben statt Hand heben');
  const res = await fetch(url, {headers:{Accept:'application/json'}});
  const data = await res.json();
  console.log(data.best);
})();
</script>

Python

import requests
r = requests.get("https://trickregister.de/api/api.php", params={"q": "Brille hochschieben"})
print(r.json())

Versionierung

Aktuelle Version: v1 (Single-Endpoint). Geplante zukünftige Struktur: /api/v2/... mit erweiterten Feldern und Filterparametern.

OpenAPI / Swagger

Die vollständige API-Spezifikation steht als maschinenlesbare Datei bereit:
OpenAPI (YAML) · OpenAPI (JSON)
Interaktive Dokumentation: Swagger UI · ReDoc