Sviluppatori

API pubblica

L'intero catalogo di soluzioni come file JSON aperto e statico – senza registrazione, senza tracciamento.

1 · Panoramica

Swiss IT Navigator mette a disposizione il suo catalogo completo e curato di soluzioni open source sovrane come API JSON pubblica e di sola lettura. I dati sono generati al momento del build su infrastruttura svizzera (RZO Gais) e serviti come file statico – nessun codice server a runtime, nessun database, nessuna raccolta di dati personali.

2 · Endpoint

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

SPEC/api/v1/openapi.json · OpenAPI 3.1 ↗ Explorer

Esiste esattamente un endpoint. Restituisce l'intero catalogo in un'unica risposta.

3 · Accesso & condizioni d'uso

Nessuna autenticazione: Nessuna API key, nessun token, nessun login.
CORS: Access-Control-Allow-Origin: * – utilizzabile direttamente dal browser.
Caching: Cache del browser 1 ora, CDN/proxy 24 ore (s-maxage). Si prega di rispettarla.
Rate limit: Nessun limite rigido; si presuppone un uso corretto. Memorizza in cache invece di interrogare di continuo.
Aggiornamento: Rigenerato a ogni deployment (in genere quotidiano), incl. le stelle GitHub attuali.

4 · Struttura della risposta

La risposta è un oggetto con metadati e l'array solutions:

Campo	Tipo	Descrizione
`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 · Oggetto Solution

Ogni voce nell'array solutions ha i seguenti campi:

Campo	Tipo	Descrizione
`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".
`audience`	`string[]`	Subset of "business" \| "private" — who realistically uses this solution.
`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").
`addedAt`	`string`	ISO date (YYYY-MM-DD) the solution was added to the catalogue.
`stars`	`number \| null`	GitHub stars at build time; null if unavailable.

6 · Esempi

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
)

Esempio di risposta (troncato)

{
  "version": 1,
  "generatedAt": "2026-06-05T08:00:00.000Z",
  "count": 123,
  "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"],
      "audience": ["business", "private"],
      "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",
      "addedAt": "2026-05-17",
      "stars": 47000
    }
  ]
}

7 · Licenza & attribuzione

Il dataset è pubblicato con licenza MIT e può essere usato liberamente – anche a scopo commerciale. Apprezziamo un'attribuzione con un link a swissitnavigator.ch. I gestori dei progetti collegati sono responsabili dei propri contenuti.

Aggiornato: giugno 2026