Créer une réponse à un commentaire avec l'API Vimeo
Ré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.
- Identifiant
- vimeo_create_comment_reply
L'appel
POST https://connect.reportei.com/api/tools/vimeo_create_comment_reply/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"video_id": 1,
"comment_id": 1,
"text": "<text>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| video_id | integer | Oui | Id of the video: the number at the end of its uri in List videos, or the first number after vimeo.com/ in the URL of the video. |
| comment_id | integer | Oui | Id of the comment: the number at the end of its uri in List video comments. |
| text | string | Oui | Text of the reply. |
Connexions possibles
Votre client connecte son compte Vimeo une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/vimeo_create_comment_reply. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
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.
