llms.txt
Índice LLM conciso para el contrato público de integración.
https://knogin.com/llms.txttext[Docs legibles por máquina]
Acceso para IA
Knogin expone una superficie de documentación legible por máquinas para el contrato estable de integración externa. Está limitada deliberadamente a temas públicos y excluye material interno o de blueprint.
llms-full.txt
Exportación Markdown completa solo del subconjunto público.
https://knogin.com/llms-full.txtmarkdown/api/docs
Índice JSON de los temas públicos de integración.
https://knogin.com/api/docsjson/api/docs/{topic}
JSON o Markdown para un tema público individual.
https://knogin.com/api/docs/{topic}json | markdownEjemplo de uso
# 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-contactLos identificadores de temas y los payloads legibles por máquinas permanecen en inglés canónico para mantener consistencia entre herramientas y locales.
Temas públicos
Estos son los únicos temas publicados en la superficie legible por 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.
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.
Qué incluye
- Registro de apps y gobernanza para integraciones externas.
- Flujos OAuth y service tokens para scopes aprobados.
- Endpoints JWKS para verificación JWT.
- Gestión de webhooks y diagnóstico de entregas.
- Guía de transporte GraphQL, autenticación y tenant scoping.
Qué se excluye deliberadamente
- Rutas internas, debug, admin o para workers.
- Enlaces a playground GraphQL, volcados de esquema e introspección.
- Flujos de control plane solo para partners.
- Blueprints de federación empresarial.