Mitarbeiter verwalten
Mitarbeiter und Empfänger lassen sich lesen. Geschäftsdaten können bearbeitet und Mitarbeiter mit gesonderter Berechtigung gelöscht werden.
Systeme sinnvoll verbinden
Eine Schnittstelle für zentrale Verwaltungsabläufe
Die REST-API macht zentrale Funktionen der RASKEN Assetverwaltung für externe Werkzeuge zugänglich. Dazu gehören auch das Bearbeiten von Mitarbeiter-Geschäftsdaten und – mit gesonderter Berechtigung – das Löschen von Mitarbeitern.
Statt Daten zwischen mehreren Anwendungen manuell zu übertragen, können freigegebene Prozesse strukturiert lesen, schreiben und automatisieren – ohne direkten Zugriff auf die zugrunde liegende Datenbank.
VersioniertPlanbare Weiterentwicklung der Schnittstelle
BegrenztRechte passend zum Einsatzzweck
NachvollziehbarÄnderungen fließen in die Historie ein
WiderrufbarZugänge lassen sich gezielt beenden
Unterstützte Bereiche
Was sich über die REST-API abbilden lässt
Granulare Berechtigungen steuern, auf welche Daten und Aktionen eine Integration zugreifen darf.
Assets und Strukturen verwalten
Assetklassen und Felder lassen sich verwalten. Assets können gelesen, angelegt, geändert und mit gesonderter Berechtigung gelöscht werden.
Zuordnungen und Erinnerungen steuern
Assets lassen sich zuordnen und zurücknehmen. Erinnerungen können gelesen, erledigt, dokumentiert und bei Bedarf erneut versendet werden.
Dokumentprozesse automatisieren
Dokumente lassen sich lesen, hochladen, bearbeiten, löschen, erzeugen, per E-Mail versenden und in HAUFE ablegen.
Kommunikation anbinden
Chats, Anhänge und Klassenposteingänge können verarbeitet, Benachrichtigungen versendet und E-Mails am passenden Asset abgelegt werden.
Daten austauschen und auswerten
Tabellenimporte, Dateiübertragungen, Dashboarddaten, Berichte, CSV-Exporte und der freigegebene Standardexport können in automatisierte Abläufe eingebunden werden.
Kontrollierter Zugriff
Zugänge passend zum jeweiligen Prozess
API-Schlüssel werden durch die Installationsadministration erstellt. Funktionsrechte, Gültigkeit und Widerruf lassen sich für jeden Zugang gezielt steuern.
Funktionen granular freigeben
Lesen, Schreiben, Löschen, Exportieren und Versenden werden über einzelne Berechtigungen gesteuert. Ein Zugang erhält nur die Rechte, die sein Ablauf benötigt.
Befristet und widerrufbar
Schlüssel erhalten ein Ablaufdatum und können vorzeitig widerrufen werden, wenn ein angebundenes System oder Prozess nicht mehr verwendet wird.
Authentifiziert über HTTPS
Unterstützt werden Bearer-Token und alternativ ein eigener API-Key-Header, beispielsweise hinter vorgeschalteter HTTP-Basic-Authentifizierung.
Keine Abkürzung an den Fachregeln vorbei: Pflichtfelder, berechnete Assetnamen, Duplikatregeln, Zuordnungsprüfungen, Löschabhängigkeiten, Historie und Vertragsschreibschutz bleiben auch bei API-Aufrufen wirksam. Größen- und Ratenbegrenzungen schützen die Schnittstelle zusätzlich.
Beispielhafte Abläufe
So kann die REST-API im Alltag eingesetzt werden
Die folgenden Beispiele zeigen mögliche Abläufe auf Basis der dokumentierten API-Funktionen. Die konkrete Anbindung an ein Drittsystem wird passend zur jeweiligen Systemlandschaft umgesetzt.
Ein- und Austritt aus einem HR- oder Ticketsystem
- Die Integration liest vorhandene Mitarbeiter und Empfänger oder aktualisiert freigegebene Geschäftsdaten.
- Benötigte Geräte werden angelegt und dem Mitarbeiter zugeordnet.
- Beim Austritt werden Zuordnungen gelesen und die Arbeitsmittel zurückgenommen.
- Falls vorgesehen, kann der Mitarbeiter anschließend mit eigener Löschberechtigung entfernt werden.
Dokumentabläufe ohne Medienbruch
- Eine Vorlage oder ein vorhandenes Dokument wird am Asset verarbeitet.
- Die Integration erzeugt eine Vorschau oder legt ein neues Dokument ab.
- Das Ergebnis wird per E-Mail versendet oder in HAUFE abgelegt.
- Getrennte Rechte begrenzen Lesen, Bearbeiten, Löschen, Versand und HAUFE-Ablage.
Import, Kontrolle und Bericht automatisieren
- Eine Integration prüft neue Tabellenimporte und führt freigegebene Importe aus.
- Dashboard-Zusammenfassungen und Berichte liefern den aktuellen Überblick.
- Berichte werden bei Bedarf als CSV oder über den Standardexport bereitgestellt.
- Aktionsquittungen helfen dabei, ausgeführte Vorgänge nachzuvollziehen.
Technischer Leistungsumfang
Berechtigungen im Überblick
Die folgenden Funktionsgruppen zeigen, wie Zugänge technisch zugeschnitten werden können. Schreib-, Lösch-, Export- und Versandaktionen werden nur mit dem jeweils passenden Scope freigegeben.
| Bereich | Verfügbare Berechtigungen |
|---|---|
| Mitarbeiter und Notizen | directory:read, employees:write, employees:delete, notes:read, notes:write, notes:delete |
| Assets und Klassen | asset-classes:read, asset-classes:write, assets:read, assets:write, assets:delete, asset-history:read |
| Zuordnungen und Erinnerungen | assignments:read, assignments:write, reminders:read, reminders:write, reminders:send |
| Dokumente | documents:read, documents:write, documents:delete, documents:generate, documents:email, documents:haufe |
| Chats und Posteingang | chats:read, chats:write, chats:file, chats:notify, mail:read, mail:file, mail:delete |
| Dateien und Importe | files:read, files:write, imports:read, imports:write |
| Dashboard, Berichte und Exporte | dashboard:read, reports:read, reports:export, contract:export |
| Administration und Rückmeldungen | asset-archives:read, operations:read, feedback:send |
Wichtig:
employees:write erlaubt die Bearbeitung von Mitarbeiter-Geschäftsdaten; employees:delete erlaubt die Löschung. Die REST-API arbeitet weiterhin über die vorgesehenen Fachdienste und stellt keinen direkten SQL-Zugriff bereit.Passend zu Ihrer Systemlandschaft
REST-API für Ihren Ablauf einplanen
Wir klären gemeinsam, welche Daten und Funktionen benötigt werden, welche Rechte der Zugang erhalten soll und wie sich der angebundene Prozess sicher in Ihre Abläufe einfügt.
Begrenzte Rechte
Befristete Schlüssel
Bestehende Fachregeln
Nachvollziehbare Änderungen