MyWorkDrive Version 7.1 führt eine leistungsstarke neue öffentliche API ein, die es Administratoren ermöglicht, die Erstellung, Konfiguration und Entfernung von Dateifreigaben und Berechtigungen über HTTP-Anfragen zu automatisieren. Diese API richtet sich an fortgeschrittene Benutzer, die die Freigabeverwaltung in externe Systeme, Skripte usw. integrieren müssen., oder Orchestrierungs-Workflows.

Erste Schritte

1. Aktivieren Sie die API
Gehen Sie zu Admin Panel > Enterprise
Aktivieren der öffentlichen API
Kopieren Sie Ihren API-Schlüssel

Alle Anfragen müssen den API-Schlüssel im HTTP-Header enthalten:
Kopfzeile: API-Schlüssel: {dein-API-Schlüssel}

2. Zugriff auf die API
API wird lokal gehostet (standardmäßig) auf:
http://127.0.0.1:8360

Freigabeverwaltungsendpunkte

Betrieb	Verfahren	Endpunkt	Hinweise
Liste alle Aktien	ERHALTEN	/API/v3/ListShares	Gibt ein Array aller Aktien zurück
Abrufen einer Freigabe nach Namen	ERHALTEN	/API/v3/GetShare?Name={Freigabename}	Gibt den Anteil zurück, falls vorhanden
Erstellen einer neuen Freigabe	ERHALTEN	/api/v3/CreateShare?name={name}&path={pfad}&storageProviderId={id}	Erfordert Speicheranbieter-ID
Löschen einer Freigabe	ERHALTEN	/API/v3/Freigabe löschen?Name={Name}	Entfernt KEINE automatischen Berechtigungen

Hinweis: Freigaben werden nur dann im Admin-Bereich angezeigt, wenn mindestens
eine Berechtigung zugewiesen ist. API-Änderungen können bis zu 5 Minuten dauern, bis sie aufgrund
zum Zwischenspeichern.

Endpunkte für die Berechtigungsverwaltung

Betrieb	Verfahren	Endpunkt	Hinweise
Alle Berechtigungen auflisten	ERHALTEN	/API/v3/ListPermissions	Listet alle Einträge auf
Listenberechtigungen für Benutzer/Gruppe	ERHALTEN	/API/v3/ListPermissions?name={name}	Filter nach Namen
Berechtigung zum Erstellen/Aktualisieren	ERHALTEN	/API/v3/Platzberechtigung?…	Siehe unten
Löschberechtigung	ERHALTEN	/API/v3/Löschberechtigung?…	Alle Felder sind Pflichtfelder

Platzberechtigung Parameter

Parameter	Typ	Erforderlich	Beschreibung
Name	Schnur	✅	Benutzer oder Gruppenname
Domänenname	Schnur	✅ für Benutzer optional für Gruppen im Entra-ID-Modus	Leere verwenden Zeichenfolge für Entra-ID-Gruppen
Freigabename	Schnur	✅	Name des Aktie
isGroup	Boolescher Wert	✅	gilt für Gruppen
webClientAllowed	Boolescher Wert	✅	Web aktivieren Clientzugriff
desktopClientAllowed	Boolescher Wert	✅	Aktivieren Zugriff auf zugeordnetes Laufwerk (Desktop)
mobileClientAllowed	Boolescher Wert	✅	Aktivieren Zugriff auf mobile Apps
publicSharingEnabled	Boolescher Wert	✅	Öffentliche zulassen Linkfreigabe
dlpDownloadEnabled	Boolescher Wert	✅	Datei zulassen Download (wenn DLP aktiviert ist)
dlpOfficeOnlineEditEnabled	Boolescher Wert	✅	Office zulassen Nur Online-Bearbeitung

Beispiel (für Entra-ID-Gruppe):
GET /api/v3/PlacePermission?name=All%20Entra%20ID%20Members&shareName=LocalTest&domainName=&isGroup=true&webClientAllowed=true&desktopClientAllowed=true&mobileClientAllowed=true&publicSharingEnabled=true&dlpDownloadEnabled=true&dlpOfficeOnlineEditEnabled=true

Speicheranbieter

Um eine Freigabe zu erstellen, benötigen Sie die Speicheranbieter-ID.

So rufen Sie es ab:
1. Gehen Sie zu Admin Panel > Integrationen
2. Erstellen Sie einen neuen Speichereintrag (z. B. Azure Blob, Azure Files, SMB)
3. Überprüfen Sie die Datei General.xml in Wanpath\wanpath.data\Einstellungen
für die generierten Speicheranbieter-ID

⚠️ Derzeit API-Unterstützung für die Speicherverwaltung
Anbieter (Hinzufügen/Löschen) wird geprüft.

Hinweise und Einschränkungen

• Cache-Verzögerung: Es kann bis zu 5 Minuten dauern, bis Updates im
das Admin-Panel.
• Löschverhalten: Das Löschen einer Freigabe löscht NICHT automatisch die zugehörigen
Berechtigungen (muss als separater Beitrag erfolgen).
• HTTP-Verben: Die API ist verbagnostisch (GET, POST, etc.), aber die Beispiele hier verwenden
GET der Einfachheit halber.
• Leerzeichen und Kodierung: URL-Parameter müssen URL-kodiert sein (zB Alle Entra ID
Members → All%20Entra%20ID%20Members).
• Änderungen: Um eine Freigabe oder Berechtigung zu ändern, löschen Sie sie und erstellen Sie sie neu.

Sicherheitsüberlegungen

Diese API ist standardmäßig für die Ausführung auf einer privaten lokalen Netzwerkschnittstelle konzipiert. Die öffentliche Zugänglichkeit sollte mit äußerster Vorsicht erfolgen. Aus Sicherheitsgründen wird die Management-API auf einer separaten IIS-Site gehostet. Wanpath.Admin.API auf Port 8360. Fügen Sie für zusätzliche Sicherheit einen Hostnamen und ein SSL-Zertifikat zu dieser IIS-Site hinzu, während Sie den Zugriff weiterhin über eine Firewall oder Authentifizierungskontrollen beschränken.