[Gecureerd publiek integratieoppervlak]

API-integraties

Knogin publiceert een gecureerd extern integratiecontract voor auth, tokens, webhooks en GraphQL-transport. Geavanceerde workflows gaan naar beoordeelde toegang in plaats van als volledige blauwdruk te worden gepubliceerd.

Wat de publieke surface omvat

Publieke integratieguidance is bewust smal en stabiel.

Identiteit en app-registratie

Registreer goedgekeurde apps, bekijk scopes en beheer governance zonder tenantbrede internals bloot te leggen.

OAuth en service tokens

Gebruik ondersteunde flows voor user-delegated access of automatisering zonder interactieve gebruiker.

Event delivery en webhooks

Maak, test en monitor uitgaande webhookabonnementen voor goedgekeurde workflows.

GraphQL-transportcontract

Verbind met het gedeelde GraphQL-transport via bearer auth en tenant scoping, zonder het volledige schema te publiceren.

Voorbeeld van het publieke contract

Dit voorbeeld blijft binnen het beoordeelde publieke contract: verkrijg een token en roep daarna het GraphQL-transport aan.

# 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 } }"}'

Integratieprincipes

Publiek wanneer stabiel

Alles wat publiek wordt gedocumenteerd moet stabiel genoeg zijn voor goedgekeurd integratiewerk.

Beoordeeld wanneer gevoelig

Geavanceerde platformworkflows, gecureerde GraphQL-bundels en omgevingsspecifieke planning blijven achter review.

Machineleesbaar als standaard

Hetzelfde publieke contract is beschikbaar via `/api/docs`, `llms.txt` en `llms-full.txt`.

Publieke contractdetails nodig?

Open de API-referentie voor de ondersteunde surface of gebruik de integratiegids wanneer je workflow beoordeelde toegang nodig heeft.