API

The API reference is being prepared.

On this page

Envelope

Every response uses the same envelope: d holds the payload or the error code, s is ok or error, t is an ISO 8601 timestamp.

Success

json
{
  "d": { "items": [] },
  "s": "ok",
  "t": "2026-11-03T12:05:00.000Z"
}

Error

json
{
  "d": "careers_posting_not_found",
  "s": "error",
  "t": "2026-11-03T10:00:00.000Z"
}

Errors

On an error, d is a machine-readable error code and the HTTP status tells the kind of problem.

  • 404: the resource does not exist, for example careers_posting_not_found.
  • 429: too many requests. Slow down and cache responses.

Authentication

  • Public endpoints need no key or token.
  • Signed-in calls use your user session (JWT).
  • Sign-in uses OpenID Connect (Authorization Code with PKCE). The discovery document (/.well-known/openid-configuration) and the JWKS (/.well-known/jwks.json) are public.

Public endpoints

Public API endpoints
MethodPathAuthReturnsExample
GET/apps/catalogPublicThe app catalog.—
GET/apps/catalog/top?limit=3PublicTop apps; limit sets how many.—
GET/apps/:slugPublicOne app by its slug.—
GET/news/publicPublicPublished release notes, newest first (60 requests per minute).See example
GET/news/public/:versionPublicOne release with its article; 404 release_not_found for an unknown version.See example
GET/careersPublicOpen positions.—
GET/careers/:slugPublicOne open position by its slug; 404 careers_posting_not_found.—

Examples

Illustrative values from the real changelog.

GET /news/public
json
{
  "d": {
    "items": [
      {
        "id": "7290000000000000031",
        "app": "ultralabs",
        "version": "0.31.0",
        "publishedAt": "2026-11-03T12:00:00.000Z",
        "summary": { "sk": "Bezpečnostná oprava prihlásenia.", "en": "Sign-in security fix." },
        "items": [
          {
            "type": "fixed",
            "text": {
              "sk": "Kontrola pôvodu pri lazy claime, claim URL na Studio hoste.",
              "en": "Lazy claim origin check, claim URL on the Studio host."
            }
          }
        ],
        "announce": false
      }
    ]
  },
  "s": "ok",
  "t": "2026-11-03T12:05:00.000Z"
}
GET /news/public/:version
json
{
  "d": {
    "release": {
      "id": "7290000000000000031",
      "app": "ultralabs",
      "version": "0.31.0",
      "publishedAt": "2026-11-03T12:00:00.000Z",
      "summary": { "sk": "Bezpečnostná oprava prihlásenia.", "en": "Sign-in security fix." },
      "items": [],
      "announce": false,
      "body": { "sk": "## Čo sa zmenilo\n…", "en": "## What changed\n…" }
    }
  },
  "s": "ok",
  "t": "2026-11-03T12:05:00.000Z"
}

Conventions

  • IDs are strings, never numbers.
  • Dates are ISO 8601 timestamps.
  • Amounts are integers in cents.
  • Localized fields hold sk and optionally en and de. Show the requested language, then English, then Slovak.

OpenAPI reference