Swagger UI
Interaktive API-Dokumentation für Pfade, Request Bodies und Response-Schemas.
Cernion Public API Recipes
Developer-Einstieg für die öffentliche Cernion API: OpenAI-kompatible Chat-Completions, Copilot-Prozess-Intents und Portal-Widget-Fixtures — mit klarer Token-, Tenant- und HITL-Grenze.
🔌 OpenAPI-verankert
🧪 synthetische Beispiele
🔐 keine Tokens im Browser
🛡️ keine produktive Mutation
Public-safe Grenze:
Diese Seite ist ein Lese- und Integrationswegweiser. Die Beispiele nutzen synthetische Daten und Platzhalter. Sie autorisieren keine produktive Ausführung, keine MaKo-, Billing-, Vertrags-, Tarif-, Geräte- oder Netzanschlussaktion und keine kundenspezifische Aussage.
Quellen der technischen Wahrheit
Öffentlich verifizierbar statt Marketing-ParalleldokumentationOpenAPI JSON
Maschinenlesbare Spezifikation für LLM-Discovery, SDK-Generierung und technische Reviews.
GitHub-Recipe
Die kanonische Recipe-Datei mit synthetischen curl- und Response-Beispielen liegt im öffentlichen Repository.
MaKo EDIFACT Sanitizer
Browser-lokales Beispiel und Open-Source-CLI für EDIFACT-Pseudonymisierung: Demo ohne Telemetrie, produktiver Weg über Installation im eigenen Netzwerk.
Drei sichere Developer-Rezepte
Endpoint, Integrationszweck und Grenze auf einen Blick1. OpenAI-kompatible Consultation
Endpoint: POST /v1/chat/completions
Wofür: Cernion als kontrollierte Assistenzfläche in n8n, OpenWebUI, Backends oder internen Copilots nutzen.
Grenze: Antwort- und Einordnungsfläche; keine Prozessausführung und keine produktive Änderung.
2. Copilot Process Intent Intake
Endpoint: POST /api/copilot-process/intents
Wofür: Eine vorgeschlagene fachliche Aktion als prüfbaren Intent mit Risiko, Grund und Korrelation vorbereiten.
Grenze: Pending-confirmation-Vertrag für menschliche Prüfung; kein freier Demo-Auslöser.
3. Customer-Service Portal Widget
Endpoint: POST /api/customer-service/portal-widget
Wofür: Synthetische FAQ-/Widget-Fixtures für Portal- und Frontend-Integration prüfen.
Grenze: synthetisches Integrationsbeispiel; keine Rechts-, Tarif-, Billing- oder Vertragsauskunft.
4. EDIFACT vor der Weitergabe pseudonymisieren
Tool: mako-edifact-sanitizer auf npm
Wofür: synthetische oder freigegebene EDIFACT-Beispiele vor Fachfeedback, Ticket oder Prompt besser bereinigen.
Grenze: keine DSGVO- oder Rechtsgarantie; echte Anonymisierung immer im eigenen Netzwerk installieren, prüfen und fachlich verantworten.
Token- und Tenant-Grenze
So dokumentieren
export CERNION_TOKEN="<set privately, never commit>"
export CERNION_TENANT="docs-sandbox-slot5"Öffentliche Beispiele verwenden nur Platzhalter oder maskierte Header wie Authorization: Bearer ***. Reale Tokens gehören in serverseitige Secret-Verwaltung.
So nicht dokumentieren
- Keine Tokens in Prompts, Screenshots, Browser-Code, Query-Strings oder Commits.
- Keine Live-Tenant-IDs, Kundendaten oder produktiven Fallnummern in öffentlichen Recipes.
- Mutation-/Intake-Pfade nicht als frei ausführbare Public-Demo darstellen.
Warum diese Seite für LLM-Discovery hilft
Für Entwickler
Die Seite bündelt die stabilen Anker: Swagger UI, OpenAPI JSON, GitHub-Recipe und drei konkrete Pfade. Dadurch können Integratoren schnell prüfen, ob ein Chat-, Intent- oder Widget-Szenario fachlich passt.
Für Such- und Antwortsysteme
Die wichtigsten Begriffe stehen in HTML, nicht nur in einer Repository-Datei: /v1/chat/completions, /api/copilot-process/intents, /api/customer-service/portal-widget, OpenAPI, Swagger UI und Token-Sicherheit.
Nächster sicherer Schritt: Einen synthetischen Integrationsfall auswählen, Auth-/Rollenmodell trennen und erst danach entscheiden, ob eine interne Demo, ein n8n-Flow oder ein Fachportal-Prototyp vorbereitet wird.