Schnittstelle und Datenabgabe
Alles, was dieses Register auf seinen Seiten zeigt, ist auch maschinenlesbar abrufbar – mit derselben Schranke und derselben Herkunft.
Die Adressen
/api/v1 | Verzeichnis: Fassung, bekannte Arten, Grenzen |
|---|---|
/api/v1/kennzahlen | Bestand je Art, davon indexierbar, Stand der Projektion |
/api/v1/themen | Der Themenkatalog mit gezählter Menge je Ausschnitt |
/api/v1/regeln | Die offengelegten Ableitungsregeln und Startvorlagen samt Fassung |
/api/v1/namensraeume | Die Namensräume mit ihrer Zahl, samt Regel und Fassung |
/api/v1/namensraum/<raum> | Ein Namensraum mit seinen Einträgen |
/api/v1/eintraege?art=mcp_server | Gefilterte Liste, dieselben Filter wie die Seite |
/api/v1/eintraege.csv?art=mcp_server | Dieselbe Liste als Tabelle, eine Spalte je Merkmal |
/api/v1/eintrag/mcp_server/<slug> | Ein Eintrag vollständig, mit Quelle und Datum je Merkmalswert |
/api/v1/aenderungen | Der Änderungsstrom, mit denselben Eingrenzungen wie der Feed |
/api/v1/matrix?art=mcp_server&a=ausfuehrungsort&b=zugangsdaten_erforderlich | Zwei Merkmale gegeneinander, mit Randsummen und jeder leeren Zelle |
/api/v1/suche?art=mcp_server | Namenssuche über Name und Bezeichner, je Bereich gezählt (Parameter q) |
/api/v1/abzug?art=mcp_server | Der gesamte Bestand in einem Abruf, eine JSON-Zeile je Eintrag |
/api/v1/abzug.csv?art=mcp_server | Derselbe vollständige Abzug als Tabelle, ohne Blätterung |
/api/v1/openapi.json | Die Beschreibung dieser Schnittstelle nach OpenAPI 3.1 |
Was dabei gilt
| Veröffentlichungsschranke | Die Schnittstelle gibt genau das heraus, was auch die Seiten zeigen. Zurückgehaltene Einträge antworten wie nicht vorhandene. |
|---|---|
| Herkunft je Wert | Jeder Merkmalswert trägt Quelle, Erhebungsdatum und Vertrauensgrad; jeder abgeleitete Wert zusätzlich seine Rohangabe. |
| Grenzen | Ein blätternder Abruf liefert 100 Einträge, höchstens 200. Weiter geht es über den Parameter versatz. Die blätternden Adressen nennen in den Kopfzeilen X-Gesamt, X-Grenze und X-Versatz, welchen Ausschnitt sie tragen. Eine Ausnahme ist der Änderungsstrom: Er nennt statt einer Gesamtzahl die Felder weitere und naechster_versatz, weil die Belegsperre erst nach der Abfrage verwirft und ein Zähler zu hoch läge. |
| Kein Schreibzugang | Es gibt keinen Weg, hier etwas einzutragen. Was im Register steht, entsteht aus Quellen und nicht aus Zusendungen. |
| Eine Abweichung in der Tabelle | Beginnt ein Wert mit einem Gleichheits-, Plus-, Minus- oder At-Zeichen, stellt die CSV-Ausgabe ihm einen Apostroph voran: Tabellenprogramme würden ihn sonst als Formel ausführen. Im JSON steht der Wert unverändert. |
Fassung der Schnittstelle: v1. Eine Änderung, die bestehende Abrufe bricht, bekommt eine neue Fassung im Pfad.
tracevero · https://tracevero.com/de/werkzeuge/schnittstelle