Archivos
OneDrive en tu producto y en tus agentes de IA, con una API
El toolkit de OneDrive cubre archivos, carpetas y su uso compartido: listar y buscar elementos, leer metadatos y un enlace de descarga, crear carpetas, renombrar, mover, copiar y eliminar elementos, crear enlaces para compartir y gestionar quién tiene acceso. El cliente conecta una cuenta personal o de Microsoft 365 una vez con OAuth, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/onedrive_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"parent_id": "<parent_id>",
"name": "<name>",
"folder": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a OneDrive.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de OneDrive. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con OneDrive.
Archivos en el drive del cliente
Deja que los usuarios exploren carpetas desde tu producto, encuentren un archivo por nombre o contenido y obtengan un enlace de descarga.
Compartir un entregable
Cuando tu producto genere un reporte o un archivo, crea una carpeta para él y un enlace para compartir, o compártelo con personas concretas por email con acceso de lectura o escritura.
Agente de IA que organiza archivos
Deja que un agente busque en el drive, renombre y mueva elementos a carpetas, copie una carpeta y liste quién tiene acceso a un archivo.
Tools
11 tools de OneDrive
- Listar elementosGETLista los archivos y carpetas dentro de una carpeta, con id, name, size, lastModifiedDateTime, webUrl y una faceta folder o file. Solo vuelve la primera página.
- Buscar elementosGETBusca en el drive por nombre de archivo, metadatos y contenido, y devuelve los archivos y carpetas encontrados con id, name, webUrl y parentReference. Solo vuelve la primera página.
- Obtener elementoGETDevuelve los metadatos de un archivo o carpeta: name, size, fechas, createdBy, webUrl, parentReference con el driveId y el id de la carpeta, y una faceta folder o file. Un archivo también tiene @microsoft.graph.downloadUrl, un enlace de descarga que no requiere iniciar sesión y vence en aproximadamente una hora.
- Crear carpetaPOSTCrea una carpeta dentro de otra carpeta y la devuelve con su id.
- Actualizar elementoPATCHRenombra un archivo o carpeta, o lo mueve a otra carpeta del mismo drive, y lo devuelve. Solo cambian los campos enviados.
- Copiar elementoPOSTCopia un archivo o carpeta, con su contenido, a una carpeta o con un nuevo nombre. La copia corre en segundo plano: la respuesta es 202 sin cuerpo, y el nuevo elemento aparece en Listar elementos cuando termine. El uso compartido no se copia.
- Eliminar elementoDELETEMueve un archivo o carpeta a la papelera de OneDrive, de donde el usuario puede restaurarlo.
- Crear enlace para compartirPOSTCrea un enlace para compartir un archivo o carpeta, o devuelve el enlace del mismo tipo que ya existe, como una permission cuyo link.webUrl es el enlace a enviar.
- Listar permisosGETLista quién tiene acceso a un archivo o carpeta: enlaces, personas y grupos, cada uno con id, roles e inheritedFrom cuando viene de una carpeta superior. El dueño ve todos los permisos; las demás personas ven solo el suyo.
- Crear permisoPOSTComparte un archivo o carpeta con personas por email, con acceso de lectura o escritura, y devuelve los nuevos permisos. Con sendInvitation true, OneDrive les envía un enlace por email. La carpeta raíz de un drive personal no se puede compartir.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/onedrive, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de OneDrive
¿Necesito implementar la API de OneDrive?
No. Connect ya trae 11 tools de OneDrive descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de OneDrive?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
