API: Störungen

Störungen über die API abfragen und melden, mit Statuswerten, Prioritäten, Störungskategorien und Reaktionszeit.

Stand:

Störungen sind in Revisio Mängel aus der Prüfung und gemeldete Störungen zugleich. Über die API kann eine Leitstelle, ein Hausmeisterportal oder eine Gebäudeleittechnik Störungen melden und ihren Stand verfolgen.

Methode Pfad Berechtigung Inhalt
GET /faults read:faults Störungen, blätterbar
GET /faults/{id} read:faults eine Störung
GET /fault-categories read:faults aktive Störungskategorien
POST /faults write:faults Störung melden

Störungen abfragen#

Filter für GET /faults: status, customer_id, site_id, asset_id sowie limit, cursor, updated_since.

{
  "data": {
    "id": "01k7d8e0f2g4h6j8k0m2n4p6q8",
    "number": "S-2026-00041",
    "title": "Erdschluss Meldergruppe 3",
    "description": "Zentrale zeigt seit 06:40 Erdschluss.",
    "status": "accepted",
    "state": "planned",
    "priority": "high",
    "level": "elevated",
    "source": "api",
    "deadline": null,
    "category": { "id": "01k79y6x5w4v3t2s1r0q9p8n7m", "name": "Erdschluss" },
    "customer_id": "01k7a3m9x2c4d5e6f7g8h9j0k1",
    "site_id": "01k7a3n4q8r2s6t0v4w8x2y6z0",
    "asset_id": "01k7a3p1b5c9d3e7f1g5h9j3k7",
    "component_id": null,
    "work_order_id": "01k7b2c4d6e8f0g2h4j6k8m0n2",
    "reported_at": "2026-11-03T05:44:10+00:00",
    "reported_by_name": "Schnittstelle: Leitstelle Nord",
    "sla_due_at": "2026-11-03T09:44:10+00:00",
    "resolved_at": null,
    "closed_at": null,
    "created_at": "2026-11-03T05:44:11+00:00",
    "updated_at": "2026-11-03T06:02:30+00:00"
  }
}

Status#

Jede Störung hat zwei Statusfelder: state ist der genaue Status in Revisio, status eine gröbere Einteilung, die für einfache Anbindungen genügt.

state in Revisio status
open Offen open
planned Eingeplant accepted
in_progress In Bearbeitung in_progress
waiting Wartet waiting
deferred Zurückgestellt waiting
declined Vom Kunden abgelehnt waiting
resolved Behoben resolved
closed Abgeschlossen closed

Der Filter status versteht beide Schreibweisen: open, accepted (= planned), in_progress, waiting (= waiting, deferred und declined), resolved, closed sowie die genauen Werte planned, deferred und declined.

Weitere Felder#

Feld Bedeutung
level Priorität in Revisio: normal oder elevated (erhöht)
priority dieselbe Priorität als normal oder high
source Herkunft: inspection (Prüfprotokoll), app (Techniker-App), manual (im Büro erfasst), portal (Kundenportal), api (Schnittstelle), expert (Sachverständiger), detector_age (Melderalter), contamination (Melderverschmutzung), disablement (Abschaltung)
work_order_id Auftrag, mit dem die Störung behoben wird, sonst der Auftrag, in dem sie gefunden wurde
sla_due_at späteste Reaktion laut Störungskategorie oder null
deadline Frist zur Behebung als Datum oder null
resolved_at, closed_at Zeitpunkt der Behebung bzw. des Abschlusses

Störung melden#

POST /faults legt eine Störung an der angegebenen Anlage an. Kunde und Objekt ergeben sich aus der Anlage.

Feld Pflicht Regel
asset_id ja Anlage aus GET /assets
title ja kurze Beschreibung, bis 255 Zeichen
description nein Einzelheiten, bis 10.000 Zeichen
category_id nein Kategorie aus GET /fault-categories
component_id nein Komponente derselben Anlage
priority nein normal oder elevated; high, critical und major werden zu elevated, low und minor zu normal
reported_at nein Zeitpunkt der Meldung, höchstens 5 Minuten in der Zukunft; Standard: jetzt
reported_by_name nein wer gemeldet hat; Standard: „Schnittstelle: “ und der Name des API-Zugangs 
curl -X POST "https://app.revisio-app.net/api/public/v1/faults" \
  -H "Authorization: Bearer rvs_IhrToken" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "01k7a3p1b5c9d3e7f1g5h9j3k7",
    "category_id": "01k79y6x5w4v3t2s1r0q9p8n7m",
    "title": "Erdschluss Meldergruppe 3",
    "description": "Zentrale zeigt seit 06:40 Erdschluss.",
    "reported_at": "2026-11-03T06:44:10+01:00"
  }'

Antwort: 201 Created mit der Störung in data und der Adresse im Header Location.

  • Ohne priority gilt die Standardpriorität der Kategorie, sonst normal.
  • Hat die Kategorie eine Reaktionszeit, setzt Revisio sla_due_at ab reported_at.
  • Die Störung erscheint im Büro unter Störungen mit der Herkunft Schnittstelle; zuständige Mitarbeiter werden wie bei jeder neuen Störung benachrichtigt.
  • Die neue Störung löst den Webhook fault.created aus, jeder spätere Statuswechsel fault.status_changed.

Tipp

Melden Sie jede Störung genau einmal. Wiederholt das Fremdsystem eine Meldung nach einer Zeitüberschreitung, prüfen Sie vorher mit GET /faults?asset_id=…&status=open, ob sie schon angekommen ist.

Störungskategorien#

GET /fault-categories liefert alle aktiven Kategorien ohne Blättern:

{
  "data": [
    { "id": "01k79y6x5w4v3t2s1r0q9p8n7m", "name": "Erdschluss", "default_priority": "high", "default_level": "elevated", "sla_hours": 4 }
  ]
}

Die Kategorien pflegen Sie unter Auftragstypen und Störungskategorien.

Schnittstelle (API und Webhooks)

  • API und Webhooks im Überblick

    Was die Schnittstelle kann, wie ein Fremdsystem angebunden wird und wo die technischen Einzelheiten stehen.

  • Grundlagen: Anmeldung, Formate, Blättern, Fehler

    Anmeldung mit Token, Berechtigungen, Datenformate, Blättern mit Cursor, Abgleich mit updated_since, Rate-Limit und Fehlercodes der API.

  • API: Stammdaten

    Kunden, Objekte, Anlagen mit SW-Nummer und Auftragstypen über die API lesen, mit Filtern und allen Feldern.

  • API: Aufträge

    Aufträge über die API abfragen, anlegen und ihren Status ändern, mit Filtern, Feldern, erlaubten Statuswechseln und Beispielen.

  • API: Berichte

    Prüfberichte über die API abfragen und das PDF über einen zeitlich begrenzten, signierten Link laden, zum Beispiel für ERP oder Dokumentenablage.

  • API: Störungen

    Störungen über die API abfragen und melden, mit Statuswerten, Prioritäten, Störungskategorien und Reaktionszeit.

  • Webhooks empfangen und prüfen

    Aufbau einer Webhook-Nachricht, Header, Prüfung der Signatur mit Beispielen für PHP, Node.js und Python, Wiederholungen, Duplikate und Reihenfolge.

  • Webhook-Ereignisse

    Alle Ereignisse, die Revisio per Webhook meldet, wann sie ausgelöst werden und welche Daten sie enthalten.

  • Anwendungsbeispiele

    Typische Anbindungen Schritt für Schritt – ERP-Abrechnung, Berichtsablage im DMS, Störungsmeldung aus einer Leitstelle, Stammdatenabgleich und Wartungsplanung im ERP.

Verwandte Artikel

  • Fotos, Störungen und Notizen

    In der Techniker-App Fotos aufnehmen, Störungen mit Priorität erfassen oder melden, Status und Behebung vermerken und Notizen schreiben.

  • Auftragstypen, Störungskategorien und Störungsvorlagen

    Einsatzarten mit Prüfvorlage, Berichtstitel und Abschlussregeln festlegen, Störungskategorien mit Priorität und Reaktionsfrist pflegen und die Störungsvorlagen finden.

  • Störungen mit Priorität und Reaktionsfrist

    Störungen melden oder bei der Prüfung feststellen, Priorität, Zuständigkeit und Status pflegen, Fristen überwachen und einen Störungseinsatz anlegen.

  • Störungen an der BMA

    Wo Störungen einer Brandmeldeanlage entstehen, wie Sie sie an der Anlage finden, nach Priorität und Status lesen und aus dem Ereignisspeicher, einer Abschaltung oder vor Ort melden.