API
Die API-Referenz wird vorbereitet.
Auf dieser Seite
Antwort-Umschlag
Jede Antwort hat denselben Umschlag: d enthält die Nutzdaten oder den Fehlercode, s ist ok oder error, t ein ISO-8601-Zeitstempel.
Erfolg
{
"d": { "items": [] },
"s": "ok",
"t": "2026-11-03T12:05:00.000Z"
}Fehler
{
"d": "careers_posting_not_found",
"s": "error",
"t": "2026-11-03T10:00:00.000Z"
}Fehler
Bei einem Fehler ist d ein maschinenlesbarer Fehlercode, der HTTP-Status nennt die Art des Problems.
- 404: die Ressource existiert nicht, zum Beispiel careers_posting_not_found.
- 429: zu viele Anfragen. Langsamer anfragen und Antworten zwischenspeichern.
Authentifizierung
- Öffentliche Endpunkte brauchen keinen Schlüssel oder Token.
- Angemeldete Aufrufe nutzen Ihre Benutzersitzung (JWT).
- Die Anmeldung nutzt OpenID Connect (Authorization Code mit PKCE). Das Discovery-Dokument (/.well-known/openid-configuration) und das JWKS (/.well-known/jwks.json) sind öffentlich.
Öffentliche Endpunkte
| Methode | Pfad | Auth | Liefert | Beispiel |
|---|---|---|---|---|
| GET | /apps/catalog | Öffentlich | Der App-Katalog. | — |
| GET | /apps/catalog/top?limit=3 | Öffentlich | Top-Apps; limit bestimmt die Anzahl. | — |
| GET | /apps/:slug | Öffentlich | Eine App anhand ihres Slugs. | — |
| GET | /news/public | Öffentlich | Veröffentlichte Versionshinweise, neueste zuerst (60 Anfragen pro Minute). | Beispiel ansehen |
| GET | /news/public/:version | Öffentlich | Eine Version samt Artikel; 404 release_not_found bei unbekannter Version. | Beispiel ansehen |
| GET | /careers | Öffentlich | Offene Stellen. | — |
| GET | /careers/:slug | Öffentlich | Eine offene Stelle anhand ihres Slugs; 404 careers_posting_not_found. | — |
Beispiele
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"
}Konventionen
- IDs sind Strings, nie Zahlen.
- Datumsangaben sind ISO-8601-Zeitstempel.
- Beträge sind ganze Zahlen in Cent.
- Lokalisierte Felder enthalten sk und optional en und de. Zeigen Sie die gewünschte Sprache, dann Englisch, dann Slowakisch.