API-Dokumentation
Eine Basis-URL, ein Header, JSON rein und raus. Die OpenAPI-Beschreibung wird aus dem laufenden Code erzeugt.
OpenAPI 3: https://feeds.gibses.com/v1/openapi.json
Authentifizierung
Senden Sie Ihren Schlüssel im Header X-API-Key. Sie erhalten ihn nach dem Abschluss per E-Mail; er wird einmal angezeigt und nur als Hash gespeichert.
curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/changes?since=2026-09-01&lang=de"
401: Schlüssel fehlt oder ungültig · 403: Plan nicht aktiv · 429: mehr als 60 Anfragen pro Minute oder Monatslimit erreicht · 400: ungültiger Cursor.
Endpunkte
| Endpoint | Liefert |
|---|---|
GET /v1/changes | Einträge in umgekehrt chronologischer Reihenfolge (first_seen desc), mit Filtern und einem Cursor für die nächste Seite. |
GET /v1/entries/{id} | Einen Eintrag nach id, mit der Auswertung in der gewünschten Sprache. |
GET /v1/standards/{ref} | Alle Einträge, die einen Normverweis nennen (gelistet, ersetzt, zurückgezogen) — seine Historie im Feed. |
GET /v1/acts | Die im Feed vorhandenen Rechtsakte mit Anzahl der Einträge und letzter Änderung. |
GET /v1/health | Anzahl der Einträge und Datum der letzten Änderung. Ohne Schlüssel. |
Parameter von /v1/changes
| Parameter | Bedeutung |
|---|---|
since | YYYY-MM-DD: nur Einträge, die ab diesem Datum in den Feed kamen. Der Starter-Plan sieht ohnehin nur die letzten 30 Tage. |
act | Rechtsakt, z. B. 2023/1230 oder 2014/35/EU. |
sector | In der Auswertung genannte Branche, z. B. packaging, woodworking. |
kind | standard_added, standard_withdrawn, standard_replaced, act_published, guide_updated, ch_transposition. |
q | Freitext, gesucht in Titel, Normverweis, Rechtsakt und Kurzfassung. |
lang | de, en oder it: Sprache der Auswertung (en, wenn diese Sprache noch nicht vorliegt). |
limit | 1–200, Standard 50. |
cursor | Opaker Wert next_cursor der vorherigen Seite. |
Beispiele
Änderungen unter der Verordnung (EU) 2023/1230 seit dem 1. September:
curl -H "X-API-Key: fk_your_key" \
"https://feeds.gibses.com/v1/changes?since=2026-09-01&act=2023/1230&lang=de&limit=20"
Historie einer Norm (Verweis URL-kodiert):
curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/standards/EN%20ISO%2013849-1:2023?lang=de"
Nächste Seite:
curl -H "X-API-Key: fk_your_key" "https://feeds.gibses.com/v1/changes?limit=50&cursor=eyJmcyI6Ii4uLiIsImlkIjo0Mn0"
Antwort (ein Eintrag, illustrativ):
{
"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": "de",
"summary": "EN ISO 13849-1:2023 ist unter der Verordnung (EU) 2023/1230 gelistet und ersetzt die Ausgabe 2015; die Konformitätsvermutung der Ausgabe 2015 endet am 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": "Performance-Level-Berechnungen gegen die Ausgabe 2023 prüfen und den Verweis in der technischen Dokumentation aktualisieren.",
"risk": "high"
}
}
Pläne und Limits
| Plan | Historie | Aufrufe pro Monat | Rate-Limit |
|---|---|---|---|
| Starter | letzte 30 Tage | 10.000 | 60/min |
| Pro | vollständig | 100.000 | 60/min |
| Custom | vollständig | 200.000 | 60/min |
Der Monatszähler beginnt am ersten Tag des Monats (UTC) neu. Über dem Limit antwortet die API mit 429 bis zum nächsten Monat; schreiben Sie an info@gibses.com, um in einen grösseren Plan zu wechseln.