Prozesse-API

Basis-URL

https://api.uslimato.com/v1

Benötigte Berechtigung: processes:read (Leseoperationen) oder processes:write (Schreiboperationen).

---

Prozesse auflisten

GET /processes

Gibt alle verfügbaren Prozessdefinitionen zurück. Für Details zur Antwortstruktur siehe die englische Dokumentation.

---

Prozessinstanzen auflisten

GET /processes/instances

Gibt Prozessinstanzen zurück (laufend und abgeschlossen).

Query-Parameter:

Parameter	Typ	Beschreibung
status	string	Nach in_progress, completed oder cancelled filtern
asset_id	string	Nach Asset filtern
process_id	string	Nach Prozessdefinition filtern

---

Prozess starten

POST /processes/:process_id/start

Benötigte Berechtigung: processes:write

Request-Body:

{
  "asset_id": "clx..."
}

---

Prozessschritt fortführen

POST /processes/instances/:instance_id/advance

Benötigte Berechtigung: processes:write

Übermittelt Daten für den aktuellen Schritt und wechselt zum nächsten.

Request-Body:

{
  "step_data": {
    "assigned_user": "user-id",
    "setup_checklist": ["OS installieren", "MDM konfigurieren"],
    "handover_signature": "data:image/png;base64,..."
  }
}

Wenn dies der letzte Schritt war, wird der Status der Instanz auf completed gesetzt.