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

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

Fehler

json
{
  "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

Öffentliche API-Endpunkte
MethodePfadAuthLiefertBeispiel
GET/apps/catalogÖffentlichDer App-Katalog.—
GET/apps/catalog/top?limit=3ÖffentlichTop-Apps; limit bestimmt die Anzahl.—
GET/apps/:slugÖffentlichEine App anhand ihres Slugs.—
GET/news/publicÖffentlichVeröffentlichte Versionshinweise, neueste zuerst (60 Anfragen pro Minute).Beispiel ansehen
GET/news/public/:versionÖffentlichEine Version samt Artikel; 404 release_not_found bei unbekannter Version.Beispiel ansehen
GET/careersÖffentlichOffene Stellen.—
GET/careers/:slugÖffentlichEine offene Stelle anhand ihres Slugs; 404 careers_posting_not_found.—

Beispiele

Beispielwerte aus dem echten 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"
}

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.

OpenAPI-Referenz