La versione 7.1 di MyWorkDrive introduce una nuova e potente API pubblica che consente agli amministratori di automatizzare la creazione, la configurazione e la rimozione di condivisioni file e autorizzazioni tramite richieste HTTP. Questa API è progettata per utenti avanzati che necessitano di integrare la gestione delle condivisioni in sistemi e script esterni., O flussi di lavoro di orchestrazione.

Iniziare

1. Abilitare l'API
Vai al pannello di amministrazione > Azienda
Abilita l'API pubblica
Copia la tua chiave API

Tutte le richieste devono includere la chiave API nell'intestazione HTTP:
Intestazione: ApiKey: {tuo-API-chiave}

2. Accedi all'API
API è ospitato localmente (per impostazione predefinita) su:
http://127.0.0.1:8360

Endpoint di gestione delle condivisioni

Operazione	Metodo	Punto finale	Note
Lista tutte le azioni	OTTENERE	/API/v3/ListShares	Restituisce un array di tutte le azioni
Ottieni una quota per nome	OTTENERE	/API/v3/GetShare?nome={NomeCondividi}	Restituisce la quota se esiste
Crea una nuova condivisione	OTTENERE	/api/v3/CreateShare?name={nome}&path={percorso}&storageProviderId={id}	Richiede storageProviderId
Elimina una condivisione	OTTENERE	/API/v3/EliminaCondividi?nome={nome}	NON rimuove automaticamente le autorizzazioni

Nota: le azioni appariranno nel pannello di amministrazione solo se almeno
viene assegnato un permesso. Le modifiche all'API potrebbero richiedere fino a 5 minuti per essere riflesse a causa
alla memorizzazione nella cache.

Endpoint di gestione delle autorizzazioni

Operazione	Metodo	Punto finale	Note
Elenca tutte le autorizzazioni	OTTENERE	/API/v3/ElencoPermessi	Elenca tutte le voci
Elenca i permessi per utente/gruppo	OTTENERE	/API/v3/ListPermissions?name={nome}	Filtri per nome
Crea/Aggiorna autorizzazione	OTTENERE	/API/v3/Permesso di posizionamento?…	Vedi sotto
Elimina autorizzazione	OTTENERE	/API/v3/EliminaPermesso?…	Tutti i campi sono obbligatori

Permesso di posizionamento Parametri

Parametro	Tipo	Necessario	Descrizione
nome	corda	✅	Utente o Nome del gruppo
nomedominio	corda	✅ per gli utenti facoltativo per i gruppi in modalità Entra ID	Usa vuoto stringa per gruppi ID Entra
NomeCondividi	corda	✅	Nome del condividere
ègruppo	booleano	✅	vero per gruppi
webClientAllowed	booleano	✅	Abilita web accesso cliente
desktopClientAllowed	booleano	✅	Abilitare accesso all'unità mappata (desktop)
mobileClientAllowed	booleano	✅	Abilitare accesso all'app mobile
Condivisione pubblica abilitata	booleano	✅	Consenti pubblico condivisione di link
dlpDownloadAbilitato	booleano	✅	Consenti file scarica (se DLP è abilitato)
dlpOfficeOnlineEditEnabled	booleano	✅	Consenti Office Solo modifica online

Esempio (per il gruppo ID Entra):
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

Fornitori di storage

Per creare una condivisione, è necessario storageProviderId.

Come recuperarlo:
1. Vai al Pannello di amministrazione > Integrazioni
2. Crea una nuova voce di archiviazione (ad esempio, Azure Blob, File di Azure, SMB)
3. Controllare il file General.xml in Wanpath\wanpath.data\impostazioni
per il generato storageProviderId

⚠️ Attualmente, supporto API per la gestione dello storage
fornitori (aggiungi/elimina) è in fase di valutazione.

Note e limitazioni

• Ritardo della cache: gli aggiornamenti potrebbero richiedere fino a 5 minuti per essere visualizzati
il pannello di amministrazione.
• Comportamento di eliminazione: l'eliminazione di una condivisione NON elimina automaticamente i file associati
permessi (devono essere fatti come post separato).
• Verbi HTTP: l'API è indipendente dai verbi (GET, POST, ecc.), ma gli esempi qui utilizzano
GET per semplicità.
• Spazi e codifica: i parametri URL devono essere codificati in URL (ad esempio, tutti gli ID Entra
Members → All%20Entra%20ID%20Members).
• Modifiche: per modificare una condivisione o un'autorizzazione, eliminarla e ricrearla.

Considerazioni sulla sicurezza

Questa API è progettata per funzionare su un'interfaccia di rete locale privata per impostazione predefinita. Renderla accessibile al pubblico richiede estrema cautela. Per motivi di sicurezza, l'API di gestione è ospitata su un sito IIS separato. API di amministrazione di Wanpath sulla porta 8360. Per una maggiore sicurezza, aggiungere un nome host e un certificato SSL a questo sito IIS continuando a limitare l'accesso tramite firewall o controlli di autenticazione.