Lister les utilisateurs avec l'API Everhour
Liste les membres de l'équipe, y compris ceux qui ont été retirés, avec id, nom, e-mail, rôle et statut. L'id est l'utilisateur des enregistrements de temps et l'argument user des outils d'enregistrement du temps.
- Identifiant
- everhour_list_users
L'appel
POST https://connect.reportei.com/api/tools/everhour_list_users/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}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 |
|---|---|---|---|
| query | string | Non | Text matched against names and email addresses. |
| limit | integer | Non | Maximum number of members returned. |
Connexions possibles
Votre client connecte son compte Everhour une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
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/everhour_list_users. Il devient la définition de tool de votre agent sans conversion.
Autres tools Everhour
- Lister les clientsGETListe les clients de l'équipe en une seule réponse, avec les ids de leurs projets et le budget avec sa consommation en cours. L'argent est en centimes et le temps en secondes.
- Créer un clientPOSTCrée un client. Les noms ne sont pas dédupliqués, consultez donc List clients d'abord. Liez à ce client les projets dont le temps est facturé.
- Mettre à jour un clientPUTModifie un client. Seuls les champs envoyés changent. Pour lier un nouveau projet, envoyez la liste complète de projects, y compris les ids déjà liés que montre List clients.
- Mettre à jour le budget d'un clientPUTCrée ou remplace le budget d'un client. Envoyez le budget complet, car les mises à jour partielles ne sont pas prises en charge. Quand le seuil est atteint, les administrateurs de l'équipe reçoivent un e-mail.
- Lister les projetsGETListe les projets auxquels l'utilisateur a accès, avec l'id du client, le type de facturation, les tarifs et le budget avec sa consommation. Les ids portent le préfixe de l'intégration, comme as:1234567890 pour Asana ou ev:1234567890 pour les projets créés dans Everhour. Les pages commencent à 1, et une page plus courte que limit est la dernière.
- Rechercher des tâchesGETRecherche des tâches par nom dans tous les projets ou dans un seul. Renvoie les ids des tâches, comme ev:3000010034, que demandent les outils d'enregistrement du temps, avec les ids des projets, le statut et les totaux de temps en secondes.
- Lister les enregistrements de tempsGETListe les enregistrements de temps de toute l'équipe sur une période, les deux jours inclus. Sans from et to, ne renvoie qu'aujourd'hui. Chaque enregistrement a le temps en secondes, l'id de l'utilisateur, dont le nom vient de List users, la date, la tâche avec les ids de ses projets et isInvoiced. Une page plus courte que limit est la dernière.
- Créer un enregistrement de tempsPOSTEnregistre du temps sur une tâche pour un jour. Un utilisateur a au plus un enregistrement par tâche et par jour : renvoyer le même utilisateur, la même tâche et la même date met à jour la durée de cet enregistrement au lieu d'en créer un autre.
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.
