[Docs legíveis por máquina]

Acesso IA

A Knogin expõe uma superfície documental legível por máquina para o contrato estável de integração externa. Está limitada deliberadamente aos temas públicos e exclui material interno ou de blueprint.

llms.txt

Índice LLM conciso para o contrato público de integração.

https://knogin.com/llms.txttext

llms-full.txt

Export Markdown completo apenas do subconjunto público.

https://knogin.com/llms-full.txtmarkdown

/api/docs

Índice JSON dos temas públicos de integração.

https://knogin.com/api/docsjson

/api/docs/{topic}

JSON ou Markdown para um tema público individual.

https://knogin.com/api/docs/{topic}json | markdown

Exemplo de utilização

# 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-contact

Os identificadores de tópico e payloads legíveis por máquina permanecem em inglês canónico para referência consistente entre ferramentas e locais.

O que está incluído

  • Registo de apps e governação para integrações externas.
  • Fluxos OAuth e service tokens para scopes aprovados.
  • Endpoints JWKS para validação JWT.
  • Gestão de webhooks e diagnóstico de entregas.
  • Orientação para transporte GraphQL, auth e tenant scoping.

O que é excluído de propósito

  • Rotas internas, debug, admin e workers.
  • Links de playground GraphQL, dumps de schema e introspeção.
  • Workflows de control plane apenas para parceiros.
  • Blueprints de federação empresarial.

Precisas também do guia humano?

Usa a referência API pública para o contrato revisto e o guia de integração quando o teu fluxo precisar de revisão de acesso ou coordenação de sandbox.