REST API nutzen
REST API
Endpunkt
https://api.tec.1885.cloud
Die interaktive OpenAPI-Referenz wird im
Developer Portal
bereitgestellt. Der MCP-Zugang bleibt davon getrennt auf
mcp.tec.1885.cloud.
Der öffentliche API-Einstieg liegt unter
https://api.tec.1885.cloud und
https://api.tec.1885.cloud/api-docs.
Authentifizierung
Jeder Nutzer oder technische Client erhält einen benannten Zuplo-Consumer-Key. Er wird bei jedem Aufruf als Bearer Credential gesendet:
Code
Der Key enthält serverseitig access_mode: read_only, eine Liste exakter
allowed_tables und – falls benötigt – allowed_products. Ein Key kann deshalb
beispielsweise Regelwerke durchsuchen, ohne Zugriff auf Personen- oder
Bewegungsdaten zu besitzen.
Die Consumer-Keys werden im Zuplo API Key Service erzeugt, rotiert und widerrufen. Cloudflare stellt Domain und Schutzebene, vergibt aber in diesem POC keine zweite Anwendungsberechtigung. Für programmatische Clients sind weder ein E-Mail-Versanddienst noch eine interaktive Benutzeranmeldung erforderlich. Eine spätere Self-Service-Oberfläche kann Einladungen und Passkey-/SSO-Anmeldung ergänzen, ohne das REST-/MCP-Scopesystem zu verändern.
Aufrufe
Code
Die Antwort liefert next_cursor und has_more. Der Cursor basiert auf dem stabilen Primärschlüssel der jeweiligen Tabelle.
Der Fachfragenkatalog liefert für jede der 50 Goldfragen den aktuellen
Antwort-, Teil- oder Blockerstatus, das zuständige Datenprodukt und – beim
Einzelaufruf – die Abnahmekriterien und Hintergrundstrategie. Er liefert
bewusst keine erfundene Fachkennzahl: catalog_status_only: true und
business_answer_included: false machen diese Grenze maschinenlesbar.
Der zusätzliche /answer-Aufruf liefert bei bereits angebundenen Fragen eine
minimierte Projektion des freigegebenen Snapshots. Fehlt Produkt, Scope, Quelle
oder Semantik, bleibt business_answer_included falsch und die Antwort enthält
stattdessen den konkreten Blocker und die Hintergrundstrategie.
Die vollständigen Request- und Response-Schemas stehen in der API Reference.