Documentazione API

Un solo URL base, un solo header, JSON in entrata e in uscita. La descrizione OpenAPI è generata dal codice in esecuzione.

OpenAPI 3: https://feeds.gibses.com/v1/openapi.json

Autenticazione

Inviate la chiave nell'header X-API-Key. La ricevete via email dopo l'abbonamento; viene mostrata una sola volta e conservata solo come hash.

curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/changes?since=2026-09-01&lang=it"

401: chiave assente o non valida · 403: piano non attivo · 429: più di 60 richieste al minuto o cap mensile raggiunto · 400: cursor non valido.

Endpoint

Endpoint	Restituisce
`GET /v1/changes`	Voci in ordine cronologico inverso (first_seen desc), con filtri e un cursor per la pagina successiva.
`GET /v1/entries/{id}`	Una voce per id, con l'interpretazione nella lingua richiesta.
`GET /v1/standards/{ref}`	Tutte le voci che citano un riferimento di norma (pubblicata, sostituita, ritirata): la sua storia nel feed.
`GET /v1/acts`	Gli atti presenti nel feed con il numero di voci e l'ultima modifica.
`GET /v1/health`	Numero di voci e data dell'ultima modifica. Senza chiave.

Parametri di /v1/changes

Parametro	Significato
`since`	YYYY-MM-DD: solo le voci entrate nel feed da questa data. Il piano Starter vede comunque solo gli ultimi 30 giorni.
`act`	Atto, es. 2023/1230 o 2014/35/UE.
`sector`	Settore citato nell'interpretazione, es. packaging, woodworking.
`kind`	standard_added, standard_withdrawn, standard_replaced, act_published, guide_updated, ch_transposition.
`q`	Testo libero cercato in titolo, riferimento della norma, atto e riassunto.
`lang`	de, en o it: lingua dell'interpretazione (en se quella lingua non è ancora disponibile).
`limit`	1–200, default 50.
`cursor`	Valore opaco next_cursor della pagina precedente.

Esempi

Modifiche sotto il Regolamento (UE) 2023/1230 dal 1° settembre:

curl -H "X-API-Key: fk_your_key" \
  "https://feeds.gibses.com/v1/changes?since=2026-09-01&act=2023/1230&lang=it&limit=20"

Storia di una norma (riferimento in URL-encoding):

curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/standards/EN%20ISO%2013849-1:2023?lang=it"

Pagina successiva:

curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/changes?limit=50&cursor=eyJmcyI6Ii4uLiIsImlkIjo0Mn0"

Risposta (una voce, illustrativa):

{
  "id": 4812,
  "kind": "standard_replaced",
  "act": "2023/1230",
  "standard_ref": "EN ISO 13849-1:2023",
  "title": "Safety of machinery — Safety-related parts of control systems — Part 1: General principles for design",
  "replaces_ref": "EN ISO 13849-1:2015",
  "cessation_date": "2027-01-20",
  "oj_ref": "OJ L, 2026/1234, 3.9.2026",
  "url": "https://eur-lex.europa.eu/eli/dec_impl/2026/1234/oj",
  "first_seen": "2026-09-04T02:31:07+00:00",
  "interpretation": {
    "lang": "it",
    "summary": "La EN ISO 13849-1:2023 è pubblicata sotto il Regolamento (UE) 2023/1230 e sostituisce l'edizione 2015; la presunzione di conformità dell'edizione 2015 cessa il 2027-01-20.",
    "sectors": [
      "packaging",
      "machine-tools",
      "robotics",
      "woodworking"
    ],
    "machine_types": [
      "machinery with safety functions in the control system"
    ],
    "ress": [
      "1.2.1",
      "1.2.2"
    ],
    "action": "Verificare i calcoli del performance level rispetto all'edizione 2023 e aggiornare il riferimento nel fascicolo tecnico.",
    "risk": "high"
  }
}

Piani e limiti

Piano	Storico	Chiamate al mese	Rate limit
Starter	ultimi 30 giorni	10.000	60/min
Pro	completo	100.000	60/min
Custom	completo	200.000	60/min

Il contatore mensile riparte il primo giorno del mese (UTC). Oltre il cap l'API risponde 429 fino al mese successivo; scrivete a info@gibses.com per passare a un piano più grande.

Prezzi · Torna a Feeds