MyWorkDrive versie 7.1 introduceert een krachtige nieuwe openbare API waarmee beheerders het aanmaken, configureren en verwijderen van bestandsshares en machtigingen kunnen automatiseren met behulp van HTTP-verzoeken. Deze API is ontworpen voor gevorderde gebruikers die sharebeheer willen integreren in externe systemen, scripts en andere toepassingen., of orkestratie-workflows.

Aan de slag

1. Schakel de API in
Ga naar Admin Panel > Enterprise
De openbare API inschakelen
Kopieer uw API-sleutel

Alle aanvragen moeten de API-sleutel in de HTTP-header bevatten:
Koptekst: ApiKey: {jouw-api-sleutel}

2. Toegang tot de API
API wordt lokaal (standaard) gehost op:
http://127.0.0.1:8360

Eindpunten voor sharebeheer

Operatie	Methode	Eindpunt	Notities
Lijst alle aandelen	KRIJGEN	/api/v3/LijstShares	Retourneert een array met alle aandelen
Ontvang een aandeel op naam	KRIJGEN	/api/v3/GetShare?naam={shareName}	Geeft aandeel terug als het bestaat
Een nieuwe share aanmaken	KRIJGEN	/api/v3/CreateShare?name={naam}&pad={pad}&storageProviderId={id}	Vereist storageProviderId
Een aandeel verwijderen	KRIJGEN	/api/v3/DeleteShare?name={naam}	Verwijdert GEEN automatisch machtigingen

Let op: Shares verschijnen alleen in het beheerderspaneel als er minimaal
er is één toestemming toegewezen. Het kan tot 5 minuten duren voordat API-wijzigingen worden weergegeven.
naar caching.

Eindpunten voor machtigingsbeheer

Operatie	Methode	Eindpunt	Notities
Alle rechten weergeven	KRIJGEN	/api/v3/Lijstmachtigingen	Geeft een lijst van alle items weer
Lijstmachtigingen voor gebruiker/groep	KRIJGEN	/api/v3/ListPermissions?name={naam}	Filters op naam
Machtiging maken/bijwerken	KRIJGEN	/api/v3/PlaatsPermissie?…	Zie hieronder
Verwijder toestemming	KRIJGEN	/api/v3/Verwijdermachtiging?…	Alle velden zijn verplicht

PlaatsPermissie Parameters

Parameter	Type	Vereist	Beschrijving
naam	snaar	✅	Gebruiker of Groepsnaam
domeinnaam	snaar	✅ voor gebruikers optioneel voor groepen in Entra ID-modus	Gebruik leeg tekenreeks voor Entra ID-groepen
shareName	snaar	✅	Naam van de deel
isGroep	Booleaanse	✅	waar voor groepen
webClientToegestaan	Booleaanse	✅	Web inschakelen cliënttoegang
desktopClientToegestaan	Booleaanse	✅	Inschakelen toegewezen schijf (desktop) toegang
mobileClientToegestaan	Booleaanse	✅	Inschakelen toegang tot mobiele apps
publicSharingEnabled	Booleaanse	✅	Publiek toestaan link delen
dlpDownloadEnabled	Booleaanse	✅	Bestand toestaan downloaden (indien DLP ingeschakeld)
dlpOfficeOnlineEditIngeschakeld	Booleaanse	✅	Office toestaan Alleen online bewerken

Voorbeeld (voor Entra ID-groep):
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

Opslagproviders

Om een share te creëren, heb je de storageProviderId.

Hoe u het kunt ophalen:
1. Ga naar Admin Panel > Integraties
2. Maak een nieuwe opslagvermelding (bijvoorbeeld Azure Blob, Azure Files, SMB)
3. Controleer het bestand General.xml in Wanpath\wanpath.data\instellingen
voor de gegenereerde storageProviderId

⚠️ Momenteel API-ondersteuning voor het beheren van opslag
aanbieders (toevoegen/verwijderen) wordt overwogen.

Opmerkingen en beperkingen

• Cachevertraging: het kan tot 5 minuten duren voordat updates in de cache verschijnen.
het beheerderspaneel.
• Verwijdergedrag: Als u een share verwijdert, worden de bijbehorende shares NIET automatisch verwijderd.
toestemmingen (moet als apart bericht worden gedaan).
• HTTP-werkwoorden: De API is werkwoord-agnostisch (GET, POST, enz.), maar voorbeelden hier gebruiken
GET voor de eenvoud.
• Spaties en codering: URL-parameters moeten URL-gecodeerd zijn (bijvoorbeeld alle Entra-ID's).
Members → All%20Entra%20ID%20Members).
• Wijzigingen: Om een share of machtiging te wijzigen, verwijdert u deze en maakt u deze opnieuw.

Beveiligingsoverwegingen

Deze API is standaard ontworpen om te draaien op een privé lokale netwerkinterface. Het openbaar toegankelijk maken ervan moet met de grootste voorzichtigheid gebeuren. Om veiligheidsredenen wordt de Management API gehost op een aparte IIS-site. Wanpath.Admin.API op poort 8360. Voor extra beveiliging kunt u een hostnaam en een SSL-certificaat aan deze IIS-site toevoegen, terwijl u de toegang via firewall of authenticatiemaatregelen beperkt.