[Kuratiertes öffentliches Integrationssurface]

API-Integrationen

Knogin veröffentlicht einen kuratierten Vertrag für externe Integration rund um Auth, Tokens, Webhooks und GraphQL-Transport. Erweiterte Workflows bleiben hinter geprüftem Zugriff statt als vollständiges Blueprint veröffentlicht zu werden.

Was die öffentliche Oberfläche umfasst

Die öffentliche Integrationsanleitung ist bewusst eng gefasst und stabil.

Identität und App-Registrierung

Registrieren Sie freigegebene Apps, prüfen Sie Scopes und verwalten Sie Governance ohne Offenlegung tenantweiter Interna.

OAuth und Service Tokens

Nutzen Sie unterstützte Flows für benutzerdelegierten Zugriff oder Automatisierung ohne interaktiven Benutzer.

Ereigniszustellung und Webhooks

Erstellen, testen und überwachen Sie ausgehende Webhook-Abonnements für freigegebene Workflows.

GraphQL-Transportvertrag

Verbinden Sie sich mit dem gemeinsamen GraphQL-Transport per Bearer-Auth und Tenant-Scoping, ohne das vollständige Schema zu veröffentlichen.

Beispiel für den öffentlichen Vertrag

Dieses Beispiel bleibt im geprüften öffentlichen Vertrag: Token abrufen und anschließend den GraphQL-Transport aufrufen.

# Exchange client credentials for a bearer token
curl -X POST https://auth.knogin.com/v1/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=<client-id>&client_secret=<client-secret>&scope=webhooks:write"

# Call the shared GraphQL transport
curl https://api.knogin.com/graphql \
  -H "Authorization: Bearer <access-token>" \
  -H "X-Tenant-Id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{"query":"query HealthCheck { viewer { id } }"}'

Integrationsprinzipien

Öffentlich, wenn stabil

Alles, was öffentlich dokumentiert ist, soll stabil genug für freigegebene Integrationsarbeit sein.

Geprüft, wenn sensibel

Erweiterte Plattform-Workflows, kuratierte GraphQL-Bundles und umgebungsspezifische Planung bleiben hinter einer Prüfung.

Standardmäßig maschinenlesbar

Derselbe öffentliche Vertrag ist über `/api/docs`, `llms.txt` und `llms-full.txt` verfügbar.

Benötigen Sie Vertragsdetails?

Öffnen Sie die API-Referenz für die unterstützte Oberfläche oder nutzen Sie den Integrationsleitfaden für geprüften Zugriff.