Authentifizierung

Erzeuge einen API-Key in den Settings -> Connections. Sende ihn als Bearer-Token im Authorization Header.

curl https://api.netcoach.ai/v1/me \
  -H "Authorization: Bearer nc_live_sk_abc123..."

Endpoints

Beispiel: Coaching-Session

curl https://api.netcoach.ai/v1/chat/sessions \
  -X POST \
  -H "Authorization: Bearer $NC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Wie baue ich Resilienz auf?", "framework": "trinity" }'

Webhooks

Wir signieren jede Payload mit X-NetCoach-Signature (HMAC-SHA256 über den raw body, prefixed mit v1=). Retries: 5x mit exponential backoff (1s, 4s, 16s, 64s, 256s).

Payload-Beispiel: tier.upgraded

{
  "id": "evt_01HXYZ...",
  "type": "tier.upgraded",
  "created": "2026-05-26T10:14:33Z",
  "data": {
    "user_id": "usr_abc123",
    "from_tier": "gold",
    "to_tier": "platinum",
    "xp_total": 15042,
    "verified_mentees": 25
  },
  "signature_version": "v1"
}

Rate-Limits

Mehr Beispiele

Vollständige Beispiel-Repos auf GitLab: gitlab.com/2026-netcoach/sdk-examples.