Entwickler

Öffentliche API

Der gesamte Lösungskatalog als offene, statische JSON-Datei – ohne Anmeldung, ohne Tracking.

1 · Überblick

Swiss IT Navigator stellt seinen vollständigen, kuratierten Katalog digital souveräner Open-Source-Lösungen als öffentliche, schreibgeschützte JSON-API bereit. Die Daten werden zur Build-Zeit auf Schweizer Infrastruktur (RZO Gais) erzeugt und als statische Datei ausgeliefert – es gibt keinen serverseitigen Laufzeit-Code, keine Datenbank und keine Erfassung personenbezogener Daten.

2 · Endpoint

GEThttps://swissitnavigator.ch/api/v1/solutions.json

Es gibt genau einen Endpoint. Er liefert das gesamte Verzeichnis in einer Antwort.

3 · Zugriff & Nutzungsbedingungen

Keine Authentifizierung: Kein API-Key, kein Token, kein Login.
CORS: Access-Control-Allow-Origin: * – direkt aus dem Browser nutzbar.
Caching: Browser-Cache 1 Stunde, CDN/Proxy 24 Stunden (s-maxage). Bitte respektieren.
Rate-Limit: Kein hartes Limit; faire Nutzung vorausgesetzt. Cachen statt pollen.
Aktualisierung: Wird bei jedem Deployment neu erzeugt (typischerweise täglich), inkl. aktueller GitHub-Sterne.

4 · Antwortstruktur

Die Antwort ist ein Objekt mit Metadaten und dem Array solutions:

Feld	Typ	Beschreibung
`version`	`number`	API schema version (currently 1).
`generatedAt`	`string`	ISO 8601 timestamp of the build that produced this file.
`count`	`number`	Number of solutions in the array.
`license`	`string`	Licence of the dataset (MIT).
`homepage`	`string`	Canonical project homepage.
`solutions`	`Solution[]`	Array of solution objects (see below).

5 · Solution-Objekt

Jeder Eintrag im Array solutions hat folgende Felder:

Feld	Typ	Beschreibung
`name`	`string`	Display name of the solution.
`category`	`string`	One of the fixed category names (e.g. "DevOps", "Storage").
`description`	`string`	German description (source of truth).
`descriptionEn`	`string`	English description.
`descriptionFr`	`string?`	French description (optional).
`descriptionIt`	`string?`	Italian description (optional).
`license`	`string`	OSI/SPDX licence identifier (e.g. "MIT", "AGPL-3.0").
`deployment`	`string[]`	Subset of "kubernetes" \| "docker" \| "linux".
`complexity`	`number`	1–10 · setup & deployment effort (lower = simpler).
`maturity`	`number`	1–10 · project stability & production-readiness (higher = more mature).
`resourceUsage`	`number`	1–10 · RAM/CPU footprint (lower = lighter).
`maintenance`	`number`	1–10 · day-to-day operational overhead (lower = less).
`tags`	`string[]`	Free-form tags, incl. "<product>-alternative" markers.
`github`	`string`	Source repository URL (GitHub or GitLab).
`website`	`string`	Official project website URL.
`icon`	`string`	Emoji used as the solution icon.
`origin`	`string`	Geographic origin label (e.g. "🇨🇭 Schweiz", "🌍 International").
`stars`	`number \| null`	GitHub stars at build time; null if unavailable.

6 · Beispiele

Shell (curl + jq)

curl -s https://swissitnavigator.ch/api/v1/solutions.json | jq '.count'

JavaScript (fetch)

const res = await fetch('https://swissitnavigator.ch/api/v1/solutions.json')
const { solutions } = await res.json()

// e.g. all low-maintenance Kubernetes-ready options
const easy = solutions.filter(
  (s) => s.deployment.includes('kubernetes') && s.maintenance <= 3
)

Beispielantwort (gekürzt)

{
  "version": 1,
  "generatedAt": "2026-06-05T08:00:00.000Z",
  "count": 110,
  "license": "MIT",
  "homepage": "https://swissitnavigator.ch",
  "solutions": [
    {
      "name": "Gitea",
      "category": "DevOps",
      "description": "Gitea ist ein selbstgehosteter Git-Service …",
      "descriptionEn": "Gitea is a self-hosted Git service …",
      "license": "MIT",
      "deployment": ["kubernetes", "docker", "linux"],
      "complexity": 2,
      "maturity": 8,
      "resourceUsage": 2,
      "maintenance": 2,
      "tags": ["git", "ci-cd", "github-alternative"],
      "github": "https://github.com/go-gitea/gitea",
      "website": "https://gitea.io",
      "icon": "🐙",
      "origin": "🌍 International",
      "stars": 47000
    }
  ]
}

7 · Lizenz & Attribution

Der Datensatz steht unter der MIT-Lizenz und darf frei verwendet werden – auch kommerziell. Wir freuen uns über eine Quellenangabe mit Link auf swissitnavigator.ch. Für die Inhalte verlinkter Projekte sind deren Betreiber verantwortlich.

Stand: Juni 2026