API

Referencia API sa pripravuje.

Na tejto stránke

Obálka odpovede

Každá odpoveď má rovnakú obálku: d nesie dáta alebo kód chyby, s je ok alebo error, t je časová pečiatka ISO 8601.

Úspech

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

Chyba

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

Chyby

Pri chybe je d strojovo čitateľný kód chyby a HTTP stav určuje druh problému.

  • 404: zdroj neexistuje, napríklad careers_posting_not_found.
  • 429: príliš veľa požiadaviek. Spomaľte a ukladajte odpovede.

Overenie

  • Verejné endpointy nepotrebujú kľúč ani token.
  • Volania po prihlásení používajú vašu používateľskú reláciu (JWT).
  • Prihlásenie používa OpenID Connect (Authorization Code s PKCE). Discovery dokument (/.well-known/openid-configuration) a JWKS (/.well-known/jwks.json) sú verejné.

Verejné endpointy

Verejné endpointy API
MetódaCestaOverenieVraciaPríklad
GET/apps/catalogVerejnýKatalóg aplikácií.—
GET/apps/catalog/top?limit=3VerejnýTop aplikácie; limit určuje počet.—
GET/apps/:slugVerejnýJedna aplikácia podľa slugu.—
GET/news/publicVerejnýZverejnené poznámky k vydaniam, najnovšie prvé (60 požiadaviek za minútu).Zobraziť príklad
GET/news/public/:versionVerejnýJedno vydanie s článkom; 404 release_not_found pri neznámej verzii.Zobraziť príklad
GET/careersVerejnýOtvorené pozície.—
GET/careers/:slugVerejnýJedna otvorená pozícia podľa slugu; 404 careers_posting_not_found.—

Príklady

Ilustratívne hodnoty zo skutočného changelogu.

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"
}

Konvencie

  • ID sú reťazce, nikdy čísla.
  • Dátumy sú časové pečiatky ISO 8601.
  • Sumy sú celé čísla v centoch.
  • Lokalizované polia obsahujú sk a voliteľne en a de. Zobrazte požadovaný jazyk, potom angličtinu, potom slovenčinu.

Referencia OpenAPI