Identité et enregistrement d’app
Enregistrez des apps approuvées, vérifiez les scopes et gérez la gouvernance sans exposer les internes du tenant.
[Surface publique curée]
Intégrations API
Knogin publie un contrat d’intégration externe curé pour auth, tokens, webhooks et transport GraphQL. Les workflows avancés passent en accès revu au lieu d’être publiés comme blueprint complet.
Ce que comprend la surface publique
Le guide public d’intégration est volontairement étroit et stable.
OAuth et service tokens
Utilisez des flux supportés pour un accès délégué par utilisateur ou une automatisation sans utilisateur interactif.
Diffusion d’événements et webhooks
Créez, testez et surveillez des abonnements webhook sortants pour des workflows approuvés.
Contrat de transport GraphQL
Connectez-vous au transport GraphQL partagé avec bearer auth et tenant scoping, sans publier le schéma complet.
Exemple de contrat public
Cet exemple reste dans le contrat public revu: obtenir un token puis appeler le transport GraphQL.
# 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 } }"}'Principes d’intégration
Public quand c’est stable
Ce qui est documenté publiquement doit être suffisamment stable pour un travail d’intégration approuvé.
Revu quand c’est sensible
Les workflows avancés, bundles GraphQL curés et revues spécifiques à l’environnement restent derrière une revue.
Lisible par machine par défaut
Le même contrat public est disponible via `/api/docs`, `llms.txt` et `llms-full.txt`.