OpenAPI 3.1 Spec
Die maschinenlesbare Spezifikation ermöglicht automatisches Client-Generieren in TypeScript, Python, Go oder jeder anderen Sprache mit openapi-generator-Unterstützung.
API
Die API: strukturierte Wissensdaten direkt in deinen Stack
RESTful, versioniert, mit OpenAPI-Spec – die Knowledgecorner-API ist so gebaut, wie Entwickler es erwarten.
Wie die API aufgebaut ist
Die Knowledgecorner-API folgt dem REST-Standard und gibt überall sauberes JSON zurück. Alle Endpunkte sind versioniert (aktuell v1), sodass Breaking Changes niemals unangekündigt eingeführt werden. Die vollständige OpenAPI 3.1-Spezifikation steht als YAML-Download bereit und lässt sich direkt in Postman, Insomnia oder jeden anderen Client importieren. Authentifizierung läuft über Bearer Tokens mit konfigurierbaren Ablaufzeiten. Rate-Limits sind plan-abhängig und werden mit jedem Response-Header transparent kommuniziert – ihr seht immer, wie viel Kontingent ihr noch habt.
Was Entwickler an der API schätzen
Interaktiver Playground
Direkt im Browser: Endpunkte aufrufen, Parameter anpassen, Antworten inspizieren – ohne lokales Setup, ohne Token-Kopieren.
Offizielle SDKs
Wir pflegen offizielle SDKs für TypeScript/Node und Python. Community-SDKs für Go und Ruby sind verlinkt. Alle SDKs werden bei jedem API-Release automatisch gebaut und getestet.
Klare Fehlermeldungen
Jeder Fehler-Response enthält einen maschinenlesbaren Code, eine menschenlesbare Beschreibung und – wo möglich – einen direkten Link zur zugehörigen Docs-Seite.
„Die OpenAPI-Spec war so sauber, dass unser TypeScript-Client in weniger als einer Stunde generiert und in den Build integriert war. Ich hatte mit mindestens einem Tag gerechnet.“
Jana Hofmann, Senior Developer, München