API-Referenz¶

kombify exponiert eine REST-API ueber https://api.kombify.io. Vollstaendige Endpoint-Doku wird automatisch aus OpenAPI-Specs generiert und kommt in Kuerze hier her.

Basics¶

Base-URL - https://api.kombify.io/v1
Auth - Bearer-Token (User-Key oder API-Key, gemanagt im Dashboard)
Format - JSON, UTF-8
Rate-Limits - per-Plan (siehe Pricing), Headers X-RateLimit-* in jedem Response

API-Keys erstellen¶

Dashboard -> Settings -> API Keys -> "Create Key".

Scopes - granular waehlbar (z.B. cloud:read, desk:write, admin:*)
Expiry - optional, default 90 Tage
Rotation - per Klick, alter Key wird sofort invalid

Erste Request¶

curl https://api.kombify.io/v1/me \
  -H "Authorization: Bearer ${KOMBIFY_KEY}"

Response:

{
  "user": {
    "id": "usr_abc123",
    "email": "you@example.com",
    "tenants": [
      { "id": "tnt_xyz789", "slug": "acme", "role": "owner" }
    ]
  }
}

Endpoints (Skeleton)¶

Detail-Doku kommt aus OpenAPI-Spec, hier nur die Themengruppen:

Auth - /v1/auth/* - Token-Refresh, Whoami
Tenants - /v1/tenants/*
Projects (Cloud) - /v1/projects/*
Deployments (Cloud) - /v1/deployments/*
Sim - /v1/sim/*
AI - /v1/ai/* (OpenAI-kompatibel)
Me - /v1/me/*
Desk - /v1/desk/*
Admin - /v1/admin/* (Team/Enterprise only)

CLI¶

npm install -g @kombify/cli
kombify login
kombify whoami

Wichtigste Commands:

Command	Zweck
`kombify login`	OAuth-Flow im Browser
`kombify deploy`	Aktuelles Verzeichnis als Cloud-Projekt deployen
`kombify logs --tail`	Live-Logs
`kombify env set KEY=val`	Env-Var setzen
`kombify rollback <id>`	Auf Deployment zurueckrollen
`kombify-sim run`	Stack-File simulieren

SDKs¶

Node - @kombify/sdk (npm)
Python - kombify (pip)
Go - github.com/KombiverseLabs/kombify-go-sdk

OpenAPI-Spec¶

https://api.kombify.io/v1/openapi.json - importierbar in Postman, Insomnia, etc.

Webhooks¶

Webhook-Endpoints konfigurierbar pro Tenant, Events:

deployment.started, deployment.succeeded, deployment.failed
ticket.created, ticket.resolved
usage.threshold_reached

Payload-Format: JSON, signiert mit HMAC-SHA256, Header X-Kombify-Signature.

Status¶

API-Status: status.kombify.io