Documentation
Guide public curé pour les intégrations externes, les workflows avec revue, les options de déploiement à haut niveau, la divulgation sécurité et la documentation lisible par machine.
API d’Intégration Externe
Contrat public stable pour enregistrement d’app, OAuth, JWKS, webhooks et transport GraphQL.
/docs/api-referenceGuide d’Intégration
Parcours recommandé pour intégrations approuvées et demandes d’accès revu.
/docs/integration-guideOptions de Déploiement
Modèles de déploiement à haut niveau et contenu partagé lors d’une revue de solution.
/docs/deploymentDocumentation Sécurité
Processus de divulgation et guide public pour des pratiques d’intégration sûres.
/docs/securityAccès IA
Documentation publique lisible par machine via `llms.txt`, `llms-full.txt` et `/api/docs`.
/docs/ai-accessObservabilité et traçage
W3C Trace Context, OpenTelemetry, X-Argus-Trace-ID.
/docs/observability-and-tracingJobs asynchrones
Mettez en file d’attente du travail long, suivez l’état et recevez des webhooks signés.
/docs/async-jobsEnvironnement sandbox
Testez les intégrations contre des connecteurs mock déterministes sans aucun trafic sortant vers le partenaire.
/docs/sandbox-environmentDécouverte et gouvernance
Découverte d’API alignée sur les standards (OpenAPI RFC 8615, catalogue RFC 9727) et en-têtes Sunset/Deprecation.
/docs/discovery-and-governanceDémarrage rapide intégration publique
Commencez par le contrat public curé. Demandez un accès revu uniquement si votre workflow nécessite des capacités partenaires ou un onboarding spécifique à un environnement.
# Discover the public documentation surface
curl https://knogin.com/api/docs | jq .
# Review the app registration contract
curl https://auth.knogin.com/v1/platform/scopes \
-H "Authorization: Bearer <admin-access-token>"
# Exchange an approved client for a 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"Les exemples de commandes restent en anglais canonique car ils correspondent directement à la surface API publique.