Identità e registrazione app
Registra app approvate, rivedi gli scope e gestisci la governance senza esporre internals del tenant.
[Superficie pubblica curata]
Integrazioni API
Knogin pubblica un contratto curato di integrazione esterna per auth, token, webhook e trasporto GraphQL. I workflow avanzati passano ad accesso revisionato invece di essere pubblicati come blueprint completo.
Cosa include la superficie pubblica
La guida pubblica di integrazione è volutamente stretta e stabile.
OAuth e service token
Usa flussi supportati per accesso delegato dall’utente o automazione senza utente interattivo.
Consegna eventi e webhook
Crea, testa e monitora sottoscrizioni webhook in uscita per workflow approvati.
Contratto di trasporto GraphQL
Connettiti al trasporto GraphQL condiviso con bearer auth e tenant scoping, senza pubblicare lo schema completo.
Esempio del contratto pubblico
Questo esempio resta dentro il contratto pubblico revisionato: ottieni un token e poi chiama il trasporto 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 } }"}'Principi di integrazione
Pubblico quando stabile
Tutto ciò che è documentato pubblicamente deve essere abbastanza stabile per lavoro di integrazione approvato.
Revisionato quando sensibile
Workflow avanzati, bundle GraphQL curati e pianificazione specifica dell’ambiente restano dietro review.
Machine-readable per default
Lo stesso contratto pubblico è disponibile tramite `/api/docs`, `llms.txt` e `llms-full.txt`.