Documentação
Orientação pública curada para integrações externas, fluxos com revisão, opções de deployment de alto nível, divulgação de segurança e documentação legível por máquina.
API de Integração Externa
Contrato público estável para registo de apps, OAuth, JWKS, webhooks e transporte GraphQL.
/docs/api-referenceGuia de Integração
Percurso recomendado para integrações aprovadas e pedidos de acesso revisto.
/docs/integration-guideOpções de Deployment
Modelos de deployment de alto nível e o que é partilhado numa revisão de solução.
/docs/deploymentDocumentação de Segurança
Processo de divulgação e orientação pública para práticas seguras de integração.
/docs/securityAcesso IA
Documentação pública legível por máquina através de `llms.txt`, `llms-full.txt` e `/api/docs`.
/docs/ai-accessArranque rápido de integração pública
Começa pelo contrato público curado. Pede acesso revisto apenas quando o teu fluxo precisar de capacidades de parceiro ou onboarding específico do ambiente.
# Discover the public documentation surface
curl https://knogin.com/api/docs | jq .
# Review the app registration contract
curl https://auth.knogin.com/v1/platform/scopes \
-H "Authorization: Bearer <admin-access-token>"
# Exchange an approved client for a 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"Os exemplos de comando mantêm-se em inglês canónico porque correspondem diretamente à superfície pública da API.