Developer Portal Overview

The Developer Portal is a self-service interface for app developers to create, manage, and monitor their apps on the SeloraX platform.

Portal URL: portal.selorax.io

API Base URL: https://portal.selorax.io/api/v1

Authentication

All API requests (except auth endpoints) require a Bearer token:

Authorization: Bearer <accessToken>

Tokens are obtained from the Auth endpoints. Access tokens expire after 1 hour and can be refreshed using the refresh token.

Core Capabilities

Feature	Description
Authentication	Password login, phone OTP login, Sign in with SeloraX (OIDC)
App Management	Create apps, configure URLs/scopes/webhooks, upload icons and screenshots
Listing Controls	Toggle `is_listed` (marketplace visibility) and `is_active` (app functionality)
Credential Rotation	Rotate `client_secret` and regenerate `session_signing_key` on demand
Installation Monitoring	View all stores that have installed your app, with status and usage metrics
Billing Dashboard	View charges, revenue ledger, and developer balance
Webhook Management	Create/update subscriptions, view delivery logs, retry failed deliveries, test webhooks
Settings	Grouped settings UI: OAuth, webhooks, embed, billing, developer info
Overview Dashboard	Aggregated stats: active installations, charge totals, webhook health

Ownership Enforcement

All app endpoints enforce ownership: you can only access apps where apps.created_by matches your authenticated user ID. Attempting to access another developer's app returns 404 APP_NOT_FOUND.

Response Envelope

All success responses use a consistent format:

{
  "status": 200,
  "message": "Success",
  "data": {}
}

Paginated endpoints return:

{
  "status": 200,
  "message": "...",
  "data": {
    "items": [],
    "page": 1,
    "limit": 20,
    "total": 0,
    "totalPages": 0
  }
}

Error responses:

{
  "status": 400,
  "code": "ERROR_CODE",
  "message": "Human-readable error message"
}

Endpoint Groups

Developer Portal Auth — Login, OTP, token refresh, profile
Developer Apps API — App CRUD, listing/status, credentials, installations, billing, settings
Developer Webhooks API — Subscriptions, deliveries, retry, testing