System 17 — Developer Portal

CLET API & Integration Layer catalogue (Phase 4 dev portal).

• OpenAPI v1 specification
• Interactive API docs (direct)
• Gateway health

Authentication

Obtain a token via IAM Keycloak (realm clet-internal). Use IAM OIDC PKCE flow or assign a System 17 role and request a token for audience system17-api.

# Example: client-credentials (service account) — use IAM-assigned users in dev
curl -s -X POST http://localhost:8080/realms/clet-internal/protocol/openid-connect/token \
  -d client_id=system17-gateway \
  -d client_secret=gateway-secret-change-me \
  -d grant_type=client_credentials

Event ingress

HMAC-signed POST /v1/events/{topic} — see README and OpenAPI.