Identidad y registro de apps
Registra apps aprobadas, revisa scopes y gestiona gobernanza sin exponer internals del tenant.
[Superficie pública curada]
Integraciones API
Knogin publica un contrato curado de integración externa para auth, tokens, webhooks y transporte GraphQL. Los workflows avanzados pasan a acceso revisado en lugar de publicarse como blueprint completo.
Qué incluye la superficie pública
La guía pública de integración es deliberadamente limitada y estable.
OAuth y service tokens
Usa flujos soportados para acceso delegado por usuario o automatización sin usuario interactivo.
Entrega de eventos y webhooks
Crea, prueba y monitoriza suscripciones webhook salientes para workflows aprobados.
Contrato de transporte GraphQL
Conéctate al transporte GraphQL compartido con bearer auth y tenant scoping, sin publicar el esquema completo.
Ejemplo del contrato público
Este ejemplo permanece dentro del contrato público revisado: obtener un token y luego llamar al transporte 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 } }"}'Principios de integración
Público cuando es estable
Todo lo documentado públicamente debe ser lo bastante estable para trabajo de integración aprobado.
Revisado cuando es sensible
Workflows avanzados, bundles GraphQL curados y planificación específica del entorno se mantienen detrás de revisión.
Legible por máquina por defecto
El mismo contrato público está disponible mediante `/api/docs`, `llms.txt` y `llms-full.txt`.