API
Referencia API sa pripravuje.
- Dokumentácia
- API
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
{
"d": { "items": [] },
"s": "ok",
"t": "2026-11-03T12:05:00.000Z"
}Chyba
{
"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
| Metóda | Cesta | Overenie | Vracia | Príklad |
|---|---|---|---|---|
| GET | /apps/catalog | Verejný | Katalóg aplikácií. | — |
| GET | /apps/catalog/top?limit=3 | Verejný | Top aplikácie; limit určuje počet. | — |
| GET | /apps/:slug | Verejný | Jedna aplikácia podľa slugu. | — |
| GET | /news/public | Verejný | Zverejnené poznámky k vydaniam, najnovšie prvé (60 požiadaviek za minútu). | Zobraziť príklad |
| GET | /news/public/:version | Verejný | Jedno vydanie s článkom; 404 release_not_found pri neznámej verzii. | Zobraziť príklad |
| GET | /careers | Verejný | Otvorené pozície. | — |
| GET | /careers/:slug | Verejný | Jedna otvorená pozícia podľa slugu; 404 careers_posting_not_found. | — |
Príklady
GET /news/public
{
"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
{
"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.