Marketing
Vimeo dans votre produit et vos agents IA, via une API
Le toolkit Vimeo couvre les vidéos du compte connecté, leurs dossiers et leurs commentaires. Votre produit ou agent IA lit les détails et le nombre de lectures, met à jour titres et confidentialité, déplace des vidéos entre dossiers et répond aux commentaires via Connect, qui gère la connexion OAuth et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/vimeo_create_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Vimeo.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Vimeo. 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 Vimeo.
Une vidéothèque dans votre produit
Un SaaS liste les vidéos Vimeo du client avec name, link, embed et stats.plays et les affiche dans sa propre interface.
Organiser les vidéos des clients
Un outil d'agence crée un dossier par client, imbrique des sous-dossiers et déplace chaque vidéo au bon endroit.
Agent de réponses
Un agent IA lit les commentaires d'une vidéo et publie une réponse en tant qu'utilisateur connecté.
Tools
10 tools Vimeo
- Lister les vidéosGETListe les vidéos téléversées par l'utilisateur connecté, avec uri, name, description, link, duration, privacy, parent_folder, tags, code d'embed et stats.plays, le nombre de lectures.
- Obtenir une vidéoGETRenvoie une vidéo : name, description, link, duration, dimensions, privacy, status, parent_folder, tags, code d'embed, miniatures et stats.plays, le nombre de lectures.
- Mettre à jour une vidéoPATCHMet à jour le titre, la description, la confidentialité ou la licence d'une vidéo de l'utilisateur connecté et la renvoie. Les champs omis gardent leur valeur.
- Lister les dossiersGETListe les dossiers de l'utilisateur connecté, avec uri, name, link, dates et le nombre de vidéos dans metadata.connections.videos.total.
- Créer un dossierPOSTCrée un dossier pour l'utilisateur connecté et le renvoie avec son uri. Sans parent_folder_uri c'est un dossier de premier niveau ; les dossiers s'imbriquent jusqu'à 10 niveaux.
- Mettre à jour un dossierPATCHRenomme un dossier de l'utilisateur connecté et le renvoie.
- Lister les vidéos d'un dossierGETListe les vidéos d'un dossier, avec uri, name, description, link, duration, privacy, tags et stats.plays, le nombre de lectures. Pagination par page.
- Déplacer une vidéo dans un dossierPUTPlace une vidéo dans un dossier de l'utilisateur connecté, qui doit en être le propriétaire. Répond 204 sans corps quand cela fonctionne.
- Lister les commentaires d'une vidéoGETListe les commentaires d'une vidéo, avec uri, text, author, date et le nombre de réponses dans metadata.connections.replies.total.
- Créer une réponse à un commentairePOSTRépond à un commentaire d'une vidéo en tant qu'utilisateur connecté et renvoie la réponse, publique comme tout commentaire de la vidéo.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/vimeo, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Vimeo
Dois-je intégrer l'API Vimeo moi-même ?
Non. Connect fournit 10 tools Vimeo 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 Vimeo ?
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.
