
Lister les enregistrements avec l'API Zoom
Liste les enregistrements cloud d'un utilisateur sur une plage de dates d'un mois maximum, chacun avec ses fichiers et liens de lecture et de téléchargement. Sans from et to, ne couvre que le jour en cours. Nécessite un forfait Pro avec enregistrement cloud activé. Passez next_page_token pour lire la page suivante.
- Identifiant
- zoom_list_recordings
L'appel
POST https://connect.reportei.com/api/tools/zoom_list_recordings/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"userId": "<userId>"
}
}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 |
|---|---|---|---|
| userId | string | Oui | me for the connected user. |
| from | string | Non | Start of the range, YYYY-MM-DD in UTC. |
| to | string | Non | End of the range, YYYY-MM-DD in UTC, up to one month after from. |
| meeting_id | integer | Non | Only the recordings of this meeting ID, from List meetings. |
| page_size | integer | Non | Meetings per page, up to 300. The default is 30. |
| next_page_token | string | Non | The next_page_token of the previous response. |
Connexions possibles
Votre client connecte son compte Zoom 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/zoom, 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/zoom_list_recordings. Il devient la définition de tool de votre agent sans conversion.
Autres tools Zoom
- Obtenir un utilisateurGETRenvoie le profil d'un utilisateur : nom, email, fuseau horaire, ID de réunion personnelle et type de forfait.
- Lister les réunionsGETListe les réunions planifiées d'un utilisateur ; les réunions instantanées ne sont pas incluses. La réponse contient meetings et next_page_token : passez next_page_token pour lire la page suivante.
- Obtenir une réunionGETRenvoie une réunion avec join_url, start_url, paramètres et, pour une réunion récurrente, ses occurrences. Le start_url expire au bout de deux heures : relisez-le ici quand nécessaire.
- Créer une réunionPOSTPlanifie une réunion pour un utilisateur et la renvoie avec join_url et start_url. Zoom accepte jusqu'à 100 de ces appels par jour et par hôte.
- Mettre à jour une réunionPATCHMet à jour une réunion ; seuls les champs envoyés changent. Avec occurrence_id, modifie une occurrence d'une réunion récurrente. Zoom accepte jusqu'à 100 mises à jour par jour et par réunion.
- Supprimer une réunionDELETESupprime une réunion. Sans occurrence_id, une réunion récurrente est supprimée avec toutes ses occurrences.
- Obtenir l'invitation d'une réunionGETRenvoie le texte d'invitation d'une réunion, avec le lien et les informations d'appel, prêt à envoyer aux invités.
- Lister les inscrits d'une réunionGETListe les inscrits d'une réunion dont l'inscription est activée. Seuls les inscrits approuvés reviennent, sauf indication contraire de status. Nécessite un forfait Pro ou supérieur. Passez next_page_token pour lire la page suivante.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
