Identidade e registo de apps
Regista apps aprovadas, revê scopes e gere governação sem expor internals do tenant.
[Superfície pública curada]
Integrações API
A Knogin publica um contrato curado de integração externa para auth, tokens, webhooks e transporte GraphQL. Workflows avançados passam para acesso revisto em vez de serem publicados como blueprint completo.
O que a superfície pública inclui
A orientação pública de integração é deliberadamente estreita e estável.
OAuth e service tokens
Usa fluxos suportados para acesso delegado por utilizador ou automação sem utilizador interativo.
Entrega de eventos e webhooks
Cria, testa e monitoriza subscrições webhook de saída para workflows aprovados.
Contrato de transporte GraphQL
Liga-te ao transporte GraphQL partilhado com bearer auth e tenant scoping, sem publicar o schema completo.
Exemplo do contrato público
Este exemplo permanece dentro do contrato público revisto: obter um token e depois chamar o 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 } }"}'Princípios de integração
Público quando estável
Tudo o que é documentado publicamente deve ser estável o suficiente para trabalho de integração aprovado.
Revisto quando sensível
Workflows avançados, bundles GraphQL curados e planeamento específico do ambiente mantêm-se atrás de revisão.
Legível por máquina por defeito
O mesmo contrato público está disponível através de `/api/docs`, `llms.txt` e `llms-full.txt`.