Fichiers
OneDrive dans votre produit et vos agents IA, via une API
Le toolkit OneDrive couvre les fichiers, les dossiers et leur partage : lister et rechercher des éléments, lire les métadonnées et un lien de téléchargement, créer des dossiers, renommer, déplacer, copier et supprimer des éléments, créer des liens de partage et gérer qui a accès. Le client connecte un compte personnel ou Microsoft 365 une fois par OAuth, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect.
15 jours d'essai. Sans carte bancaire.
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": {}
}
}Fonctionnement
Du client connecté au premier appel à OneDrive.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte OneDrive. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec OneDrive.
Fichiers dans le drive du client
Laissez les utilisateurs parcourir les dossiers depuis votre produit, trouver un fichier par nom ou contenu et obtenir un lien de téléchargement.
Partager un livrable
Une fois qu'un rapport ou un fichier est généré par votre produit, créez un dossier pour lui et un lien de partage, ou partagez-le avec des personnes précises par email en lecture ou en écriture.
Agent IA qui range les fichiers
Laissez un agent chercher dans le drive, renommer et déplacer des éléments dans des dossiers, copier un dossier et lister qui a accès à un fichier.
Tools
11 tools OneDrive
- Lister les élémentsGETListe les fichiers et dossiers d'un dossier, avec id, name, size, lastModifiedDateTime, webUrl et une facette folder ou file. Seule la première page revient.
- Rechercher des élémentsGETRecherche dans le drive par nom de fichier, métadonnées et contenu, et renvoie les fichiers et dossiers trouvés avec id, name, webUrl et parentReference. Seule la première page revient.
- Obtenir un élémentGETRenvoie les métadonnées d'un fichier ou dossier : name, size, dates, createdBy, webUrl, parentReference avec le driveId et l'id du dossier, et une facette folder ou file. Un fichier a aussi @microsoft.graph.downloadUrl, un lien de téléchargement sans connexion qui expire au bout d'environ une heure.
- Créer un dossierPOSTCrée un dossier dans un autre dossier et le renvoie avec son id.
- Modifier un élémentPATCHRenomme un fichier ou dossier, ou le déplace vers un autre dossier du même drive, et le renvoie. Seuls les champs envoyés changent.
- Copier un élémentPOSTCopie un fichier ou dossier, avec son contenu, vers un dossier ou sous un nouveau nom. La copie s'exécute en arrière-plan : la réponse est 202 sans corps, et le nouvel élément apparaît dans Lister les éléments une fois terminée. Le partage n'est pas copié.
- Supprimer un élémentDELETEDéplace un fichier ou dossier vers la corbeille de OneDrive, d'où l'utilisateur peut le restaurer.
- Créer un lien de partagePOSTCrée un lien de partage pour un fichier ou dossier, ou renvoie le lien du même type qui existe déjà, sous forme de permission dont link.webUrl est le lien à envoyer.
- Lister les permissionsGETListe qui a accès à un fichier ou dossier : liens, personnes et groupes, chacun avec id, roles et inheritedFrom quand il vient d'un dossier parent. Le propriétaire voit toutes les permissions ; les autres personnes ne voient que la leur.
- Créer une permissionPOSTPartage un fichier ou dossier avec des personnes par email, en lecture ou en écriture, et renvoie les nouvelles permissions. Avec sendInvitation true, OneDrive leur envoie un lien par email. Le dossier racine d'un drive personnel ne peut pas être partagé.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/onedrive, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit OneDrive
Dois-je intégrer l'API OneDrive moi-même ?
Non. Connect fournit 11 tools OneDrive décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte OneDrive ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
