[Docs machine-readable]

Accesso IA

Knogin espone una superficie documentale machine-readable per il contratto stabile di integrazione esterna. È volutamente limitata ai temi pubblici ed esclude materiale interno o di blueprint.

llms.txt

Indice LLM conciso per il contratto pubblico di integrazione.

https://knogin.com/llms.txttext

llms-full.txt

Export Markdown completo del solo sottoinsieme pubblico.

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

/api/docs

Indice JSON dei temi pubblici di integrazione.

https://knogin.com/api/docsjson

/api/docs/{topic}

JSON o Markdown per un singolo tema pubblico.

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

Esempio di utilizzo

# 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

Gli identificatori dei topic e i payload machine-readable restano in inglese canonico per poter essere referenziati in modo coerente tra strumenti e lingue.

Cosa è incluso

  • Registrazione app e governance per integrazioni esterne.
  • Flussi OAuth e service token per scope approvati.
  • Endpoint JWKS per verifica JWT.
  • Gestione webhook e diagnostica di delivery.
  • Guida su trasporto GraphQL, autenticazione e tenant scoping.

Cosa è escluso intenzionalmente

  • Rotte interne, debug, admin e worker.
  • Link al playground GraphQL, dump di schema e introspezione.
  • Workflow control plane solo partner.
  • Blueprint di federazione enterprise.

Ti serve anche la guida umana?

Usa la reference API pubblica per il contratto revisionato e la guida di integrazione quando il workflow richiede revisione accessi o coordinamento sandbox.