Konstruct API Server
Local admin/licensing API for Konstruct. Use the website admin UI with
api_server_url pointed here, or call these routes directly with the right auth.
Service
konstruct-api-server
Port
8080
Billing
Paddle production
Public
| Method | Path | Auth | Description | |
|---|---|---|---|---|
| GET | /health |
None | JSON health check and service metadata. | Try |
Admin
| Method | Path | Auth | Description | |
|---|---|---|---|---|
| GET | / |
Supabase admin (browser UI) | This overview page (admin sign-in required). | Try |
| GET | /admin |
Supabase admin (browser UI) | Sign in and browse licenses/subscriptions. | Try |
| GET | /admin/events |
Supabase admin (browser UI) | Sign in and browse logged Paddle webhook events. | Try |
| GET | /admin/events/feed |
Supabase admin JWT | JSON feed of webhook events from the NDJSON log. | — |
| GET | /admin/licenses |
Supabase admin JWT | List manual licenses and Paddle subscriptions (includes licenseKey on each entry). | — |
| GET | /admin/licenses/:id |
Supabase admin JWT | Fetch one license by manual UUID or Paddle subscription id (includes licenseKey). | — |
| POST | /admin/licenses |
Supabase admin JWT | Issue a signed license and email it to the customer. | — |
| POST | /admin/licenses/:id/resend |
Supabase admin JWT | Re-send the license email for a manual license row (returns licenseKey). | — |
| GET | /admin/paddle/subscriptions/check |
Supabase admin JWT | Look up a stored subscription by subscription_id or email (database). | — |
Client (desktop app)
| Method | Path | Auth | Description | |
|---|---|---|---|---|
| GET | /client/subscriptions |
Client API key | Subscription lookup for Konstruct desktop builds (database). | — |
Webhooks
| Method | Path | Auth | Description | |
|---|---|---|---|---|
| POST | /webhooks/paddle |
Paddle signature | Paddle Billing webhook receiver; updates subscription state and issues licenses on subscription.activated. | — |
Admin UI: /admin (subscriptions) ·
/admin/events (webhook log).