llms.txt
Index LLM concis pour le contrat public d’intégration.
https://knogin.com/llms.txttext[Docs lisibles par machine]
Accès IA
Knogin expose une surface documentaire lisible par machine pour le contrat stable d’intégration externe. Elle se limite volontairement aux sujets publics et exclut les éléments internes ou de blueprint.
llms-full.txt
Export Markdown complet du seul sous-ensemble public.
https://knogin.com/llms-full.txtmarkdown/api/docs
Index JSON des sujets publics d’intégration.
https://knogin.com/api/docsjson/api/docs/{topic}
JSON ou Markdown pour un sujet public donné.
https://knogin.com/api/docs/{topic}json | markdownExemple d’usage
# Read the public topic index
curl https://knogin.com/api/docs | jq .
# Fetch a single public topic
curl https://knogin.com/api/docs/oauth-service-tokens
# Export the full public subset as Markdown
curl https://knogin.com/llms-full.txt
# Request advanced integration access
open https://knogin.com/docs/integration-guide#vendor-contactLes identifiants de sujet et payloads lisibles par machine restent en anglais canonique pour une référence cohérente entre outils et locales.
Sujets publics
Ce sont les seuls sujets publiés via la surface documentaire lisible par IA.
Knogin External Integration API
Stable public integration documentation for external integrators. This surface covers app registration, OAuth, JWKS verification, webhooks, and GraphQL transport only.
Identity and app registration
Register an integration, inspect allowed scopes, and manage governance settings for an external app.
OAuth and service tokens
Use OAuth 2.0 authorization code or client credentials flows, then rotate credentials without exposing internal auth flows.
JWKS and token verification
Verify Knogin-issued JWTs against public JWKS endpoints rather than relying on private signing details.
Event delivery and webhooks
Create, test, and observe webhook deliveries for approved outbound integrations.
GraphQL transport contract
Connect to the shared GraphQL transport with bearer authentication and tenant scoping, without publishing the full schema or operation inventory.
Observability and tracing
W3C Trace Context propagation, OpenTelemetry instrumentation, X-Argus-Trace-ID and X-Argus-Span-ID response headers, and a tenant-scoped trace lookup endpoint.
Async jobs
Enqueue long-running work (intelligence.enrich.bulk, export.bulk, import.bulk, graph.compute), poll status, fetch results, cancel, list, and receive HMAC-signed webhook callbacks. Tenant-scoped with 24h Idempotency-Key replay.
Sandbox environment
Issue short-lived sandbox tokens (aud=sandbox) and route the entire v2026.4 surface to deterministic mock connectors at https://sandbox-api.knogin.com. Dual gate prevents leak between sandbox and live.
Provenance and compliance
Signed Merkle-chained transcripts of every evidence operation. Fetch as JSON or PROV-O JSON-LD, verify server-side or offline in the SDK, and present as a chain of custody for legal proceedings. HMAC-SHA256 default with ML-DSA-65 (post-quantum) opt-in.
Discovery and governance
Standards-aligned API discovery (RFC 8615 OpenAPI well-known, RFC 9727 API catalog, reflective tenant-aware data schema listing) plus Sunset and Deprecation header behaviour driven by the published deprecation matrix.
Ce qui est inclus
- Enregistrement d’app et gouvernance pour intégrations externes.
- Flux OAuth et service tokens pour scopes approuvés.
- Endpoints JWKS pour la vérification JWT.
- Gestion des webhooks et diagnostic des livraisons.
- Guide de transport GraphQL, auth et tenant scoping.
Ce qui est volontairement exclu
- Routes internes, debug, admin et workers.
- Liens vers playground GraphQL, dumps de schéma et introspection.
- Workflows control plane réservés aux partenaires.
- Blueprints de fédération entreprise.