La versión 7.1 de MyWorkDrive presenta una nueva y potente API pública que permite a los administradores automatizar la creación, configuración y eliminación de recursos compartidos de archivos y permisos mediante solicitudes HTTP. Esta API está diseñada para usuarios avanzados que necesitan integrar la gestión de recursos compartidos en sistemas y scripts externos., o flujos de trabajo de orquestación.

Empezando

1. Habilitar la API
Vaya al Panel de administración > Empresa
Habilitar la API pública
Copia tu clave API

Todas las solicitudes deben incluir la clave API en el encabezado HTTP:
Encabezamiento: Clave API: {su-API-llave}

2. Acceda a la API
API está alojado localmente (por defecto) en:
http://127.0.0.1:8360

Puntos finales de gestión de recursos compartidos

Operación	Método	Punto final	Notas
Lista todas las acciones	CONSEGUIR	/API/v3/Listas compartidas	Devuelve una matriz de todas las acciones
Obtener una acción por nombre	CONSEGUIR	/API/v3/ObtenerCompartir?nombre={nombreCompartir}	Devuelve la acción si existe
Crear un nuevo recurso compartido	CONSEGUIR	/api/v3/CreateShare?name={nombre}&path={ruta}&storageProviderId={id}	Requiere ID del proveedor de almacenamiento
Eliminar un recurso compartido	CONSEGUIR	/API/v3/Eliminar nombre de Share?={nombre}	NO elimina automáticamente los permisos

Nota: Las acciones solo aparecerán en el Panel de administración si al menos
Se asigna un permiso. Los cambios en la API pueden tardar hasta 5 minutos en reflejarse debido a
al almacenamiento en caché.

Puntos finales de gestión de permisos

Operación	Método	Punto final	Notas
Listar todos los permisos	CONSEGUIR	/API/v3/Lista de permisos	Enumera todas las entradas
Lista de permisos para usuarios/grupos	CONSEGUIR	/API/v3/ListPermissions?name={nombre}	Filtros por nombre
Permiso para crear/actualizar	CONSEGUIR	/API/v3/Permiso de lugar?…	Vea abajo
Eliminar permiso	CONSEGUIR	/API/v3/Eliminar permiso?…	Todos los campos son obligatorios

Permiso de lugar Parámetros

Parámetro	Tipo	Requerido	Descripción
nombre	cadena	✅	Usuario o Nombre del grupo
nombre de dominio	cadena	✅ para los usuarios Opcional para grupos en modo Entra ID	Utilizar vacío cadena para grupos de ID de Entra
nombreCompartir	cadena	✅	Nombre de la compartir
esGrupo	booleano	✅	cierto para grupos
Cliente web permitido	booleano	✅	Habilitar la web acceso de cliente
Cliente de escritorio permitido	booleano	✅	Habilitar acceso a la unidad asignada (escritorio)
Cliente móvil permitido	booleano	✅	Habilitar acceso a la aplicación móvil
uso compartido público habilitado	booleano	✅	Permitir público compartir enlaces
Descarga dlp habilitada	booleano	✅	Permitir archivo Descargar (si DLP está habilitado)
dlpOfficeOnlineEditEnabled	booleano	✅	Permitir Office Sólo edición en línea

Ejemplo (para el grupo de identificación de 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

Proveedores de almacenamiento

Para crear una acción, necesitas el ID del proveedor de almacenamiento.

Cómo recuperarlo:
1. Vaya al Panel de administración > Integraciones
2. Cree una nueva entrada de almacenamiento (por ejemplo, Azure Blob, Azure Files, SMB)
3. Verifique el archivo General.xml en Wanpath\wanpath.data\ajustes
para el generado ID del proveedor de almacenamiento

⚠️ Actualmente, soporte de API para administrar el almacenamiento
Se está considerando agregar o eliminar proveedores.

Notas y limitaciones

• Retraso de caché: las actualizaciones pueden tardar hasta 5 minutos en aparecer en
El panel de administración.
• Comportamiento de eliminación: eliminar un recurso compartido NO elimina automáticamente los recursos asociados.
Permisos (debe hacerse como una publicación separada).
• Verbos HTTP: La API es independiente de los verbos (GET, POST, etc.), pero los ejemplos aquí utilizan
GET por simplicidad.
• Espacios y codificación: los parámetros de URL deben estar codificados en URL (por ejemplo, All Entra ID
Members → All%20Entra%20ID%20Members).
• Modificaciones: Para modificar un recurso compartido o permiso, elimínelo y vuelva a crearlo.

Consideraciones de Seguridad

Esta API está diseñada para ejecutarse en una interfaz de red local privada de forma predeterminada. Debe hacerse con extrema precaución al hacerla pública. Por seguridad, la API de administración se aloja en un sitio IIS independiente. API de administración de Wanpath en el puerto 8360. Para mayor seguridad, agregue un nombre de host y un certificado SSL a este sitio IIS mientras continúa limitando el acceso a través del firewall o los controles de autenticación.