REST-API
Mirador aus Skripten und anderen Werkzeugen ansprechen – Zugang, Anmeldung mit Token und die wichtigsten Pfade.
Im Aufbau. Die Dokumentation ist noch nicht vollständig. Fehlt Ihnen etwas, schreiben Sie uns: support@wiestigo.com
Stand 11. Oktober 2026 · geprüft an Wiestigo Mirador 0.1.0
Alles, was die Oberfläche kann, geschieht über eine REST-API mit JSON. Sie steht Ihnen für Skripte, Auswertungen und eigene Anbindungen offen.
Pfade
Die API erreichen Sie über denselben Zugang wie die Oberfläche:
| Pfad | Dienst |
|---|---|
/api/… | Projekte, Artefakte, Beziehungen, Baselines, Reviews, Varianten |
/identity/api/… | Anmeldung, Konten, eigenes Profil und Token |
/document/api/… | Dokumente erzeugen und abholen |
/intelligence/api/… | KI-Analyse |
Interne Pfade (/internal/, /actuator/ und einige Kontopfade) sind von
außen gesperrt.
Anmelden mit einem API-Token
Für Skripte legen Sie ein persönliches API-Token an: unter dem Kontosymbol Profil → API-Token → Token erstellen.
- Sie geben eine Bezeichnung und eine Gültigkeit an: 1 Tag, 7 Tage, 30 Tage oder unbegrenzt. Ihr Betrieb kann die längste Gültigkeit begrenzen.
- Das Token wird einmal angezeigt. Bewahren Sie es auf wie ein Kennwort.
- Ein Token hat genau Ihre Rechte – nicht mehr, nicht weniger. Bis zu 20 Token je Konto sind gleichzeitig gültig.
- Ein widerrufenes Token wirkt nach spätestens 30 Sekunden nicht mehr.
Das Token steht im Kopf jeder Anfrage:
curl -H "Authorization: Bearer rmm_pat_…" \
https://mirador.example.com/api/specifications
Ein Token kann keine Token, Kennwörter oder Konten verwalten; dafür braucht es eine angemeldete Sitzung in der Oberfläche. Für technische Konten legt der Administrator Token in der Administration an, im Bereich Users beim jeweiligen Konto.
Alternativ meldet sich ein Programm mit Benutzername und Kennwort an
(POST /identity/api/auth/login) und erhält ein Sitzungstoken, das 12
Stunden gilt.
Die Pfade nachschlagen
Der Administrator sieht in der Administration im Bereich Request Points
die Pfade des Modell- und des Identitätsdienstes mit Methode und – wo
vorhanden – Beschreibung, erzeugt aus dem laufenden System. Die Pfade unter
/document/api/ und /intelligence/api/ stehen dort nicht.
Änderungen aus anderen Werkzeugen melden
Ein angebundenes Werkzeug kann Mirador über einen Webhook mitteilen, dass sich etwas geändert hat:
POST /api/adapters/<werkzeug>/events
X-RMM-Webhook-Secret: <Geheimnis>
{ "externalProjectId": "BRAKE", "elementIds": ["BRAKE-12"] }
Mirador antwortet mit 202 und holt die Änderungen kurz darauf. Ohne
eingerichtetes Geheimnis ist der Webhook aus (404), ein falsches
Geheimnis ergibt 401.
Eigene Adapter
Für Werkzeuge außer Jira und Jama lassen sich eigene Adapter anbinden – als Plugin, das Mirador lädt, oder als eigener Dienst in einer beliebigen Sprache, der über HTTP und JSON mit Mirador spricht. Ein Adapter läuft erst, wenn der Administrator ihn freigibt. Sprechen Sie uns an, wenn Sie einen Adapter planen.