MyWorkDrive version 7.1 introduit une nouvelle API publique performante qui permet aux administrateurs d'automatiser la création, la configuration et la suppression de partages de fichiers et d'autorisations via des requêtes HTTP. Cette API est destinée aux utilisateurs avancés souhaitant intégrer la gestion des partages à des systèmes et scripts externes., ou workflows d'orchestration.

Commencer

1. Activer l'API
Accédez au Panneau d'administration > Entreprise
Activer l'API publique
Copiez votre clé API

Toutes les requêtes doivent inclure la clé API dans l'en-tête HTTP :
En-tête : Clé API: {ton-API-clé}

2. Accéder à l'API
API est hébergé localement (par défaut) sur :
http://127.0.0.1:8360

Points de terminaison de gestion des partages

Opération	Méthode	Point final	Remarques
Liste toutes les actions	OBTENIR	/API/v3/ListShares	Renvoie un tableau de toutes les actions
Obtenez une part par nom	OBTENIR	/API/v3/GetShare?nom={shareName}	Renvoie le partage s'il existe
Créer un nouveau partage	OBTENIR	/api/v3/CreateShare?name={nom}&path={chemin}&storageProviderId={id}	Nécessite ID du fournisseur de stockage
Supprimer un partage	OBTENIR	/API/v3/SupprimerPartager?nom={nom}	Ne supprime PAS automatiquement les autorisations

Remarque : les partages n'apparaîtront dans le panneau d'administration que si au moins
Une seule autorisation est attribuée. Les modifications de l'API peuvent prendre jusqu'à 5 minutes pour être appliquées.
à la mise en cache.

Points de terminaison de gestion des autorisations

Opération	Méthode	Point final	Remarques
Lister toutes les autorisations	OBTENIR	/API/v3/Liste des autorisations	Répertorie toutes les entrées
Répertorier les autorisations pour l'utilisateur/le groupe	OBTENIR	/API/v3/ListPermissions?name={nom}	Filtres par nom
Créer/Mettre à jour l'autorisation	OBTENIR	/API/v3/PlacePermission?…	Voir ci-dessous
Supprimer l'autorisation	OBTENIR	/API/v3/Supprimer l'autorisation?…	Tous les champs sont obligatoires

PlacePermission Paramètres

Paramètre	Taper	Requis	La description
nom	chaîne	✅	Utilisateur ou Nom du groupe
nom de domaine	chaîne	✅ pour les utilisateurs facultatif pour les groupes en mode Entra ID	Utiliser vide chaîne pour les groupes d'ID Entra
shareName	chaîne	✅	Nom du partager
isGroup	booléen	✅	vrai pour groupes
webClientAllowed	booléen	✅	Activer le Web accès client
desktopClientAllowed	booléen	✅	Permettre accès au lecteur mappé (bureau)
mobileClientAllowed	booléen	✅	Permettre accès aux applications mobiles
Partage public activé	booléen	✅	Autoriser le public partage de liens
dlpDownloadEnabled	booléen	✅	Autoriser le fichier télécharger (si DLP activé)
dlpOfficeOnlineEditActivé	booléen	✅	Autoriser le bureau Édition en ligne uniquement

Exemple (pour le groupe Entra ID) :
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

Fournisseurs de stockage

Pour créer un partage, vous avez besoin du ID du fournisseur de stockage.

Comment le récupérer :
1. Accédez au Panneau d'administration > Intégrations
2. Créez une nouvelle entrée de stockage (par exemple, Azure Blob, Azure Files, SMB)
3. Vérifiez le fichier General.xml dans Wanpath\wanpath.data\paramètres
pour le généré ID du fournisseur de stockage

⚠️ Actuellement, prise en charge de l'API pour la gestion du stockage
Les fournisseurs (ajout/suppression) sont à l'étude.

Notes et limitations

• Délai de mise en cache : les mises à jour peuvent prendre jusqu'à 5 minutes pour apparaître dans
le panneau d'administration.
• Comportement de suppression : la suppression d'un partage ne supprime PAS automatiquement les éléments associés
autorisations (doit être fait dans un message séparé).
• Verbes HTTP : l'API est indépendante des verbes (GET, POST, etc.), mais les exemples ici utilisent
OBTENEZ pour la simplicité.
• Espaces et codage : les paramètres d'URL doivent être codés en URL (par exemple, tous les identifiants d'entrée
Members → All%20Entra%20ID%20Members).
• Modifications : Pour modifier un partage ou une autorisation, supprimez-le et recréez-le.

Considérations de sécurité

Cette API est conçue pour fonctionner par défaut sur une interface réseau locale privée. Son accès public doit être effectué avec la plus grande prudence. Pour des raisons de sécurité, l'API de gestion est hébergée sur un site IIS distinct. Wanpath.Admin.API sur le port 8360. Pour plus de sécurité, ajoutez un nom d’hôte et un certificat SSL à ce site IIS tout en continuant à limiter l’accès via un pare-feu ou des contrôles d’authentification.