Partager via

Mes heures (préversion)

Suivez le temps et gérez les projets, les tâches, les clients et les balises avec des sélecteurs dynamiques. Ce connecteur expose les points de terminaison pour la création et la recherche d’entités.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Mes heures
URL https://myhours.com
Messagerie électronique support@myhours.com
Métadonnées du connecteur
Éditeur Spica International
Site web https://myhours.com
Politique de confidentialité https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Catégories Productivité

Mes heures - Présentation du connecteur

Suivez le temps et gérez les projets, les tâches, les clients et les balises à l’aide du connecteur Mes heures.

Authentication

Type: Clé API (en-tête)

Lors de la création d’une connexion, entrez la valeur complète dans le champ unique nommé Authorization à l’aide de ce format exact :

Exemple : apikey 123abcXYZ

Le connecteur envoie cette valeur en tant qu’en-tête Authorization sur chaque requête.

Où obtenir la clé : À partir des paramètres de votre compte Mes heures. Créez ou copiez une clé API. Conservez-le secret et faites-le pivoter s’il est exposé.

Actions prises en charge

  • Créer un client : créez un client.
  • Rechercher le client par nom : renvoyer les clients qui correspondent au nom fourni.
  • Créer un projet : créez un projet.
  • Rechercher un projet par nom : recherchez un projet par nom.
  • Ajouter une tâche au projet : créez une tâche sur un projet sélectionné.
  • Rechercher la tâche par nom : recherchez une tâche de projet par nom et ID de projet.
  • Créer une balise : créez une balise (avec une couleur hexadécimal).
  • Rechercher une balise par nom : recherchez une balise par nom.
  • Créer un journal d’heure : créez un journal d’heure.
  • Obtenir les journaux d’heure : récupérer les journaux d’activité/heure détaillés pour une plage de dates.

Déclencheurs pris en charge

  • Lorsqu’un projet est créé , se déclenche lorsqu’un nouveau projet s’affiche.
  • Lorsqu’une tâche est créée , se déclenche lorsqu’une nouvelle tâche de projet s’affiche.
  • Lorsqu’un nouveau journal d’heure est créé , se déclenche lorsqu’un nouveau journal d’heure s’affiche.

Notes d’utilisation &limites

  • Format d’autorisation : la connexion nécessite le préfixe apikey littéral suivi de votre clé. Si vous omettez le préfixe ou ajoutez des caractères supplémentaires, les demandes peuvent échouer avec 400 ou 401.
  • Formats date/heure : les dates sont AAAA-MM-DD. Les valeurs de date/heure sont ISO 8601 (par exemple 2025-09-05T08:30:00Z , un décalage local).
  • Création de journaux d’activité de temps : indiquez (duration secondes) ou les deux start et end. L’approvisionnement des trois n’est pas valide.
  • Sélecteurs dynamiques : les champs Projet, Tâche, Balise et Utilisateur utilisent des listes dynamiques ; vérifiez que votre compte dispose de l’autorisation de lire ces entités ou que les listes peuvent être vides.
  • Environnement : seul l’hôte d’API de production est pris en charge : https://api2.myhours.com.

Gestion des erreurs

Le connecteur retourne des codes d’état HTTP standard :

Code Meaning Causes classiques
200 Success Opérations de lecture/liste.
201 Créé Opérations de création réussies.
400 Demande incorrecte Entrées manquantes/non valides, format d’en-tête incorrect, champs de corps en conflit.
500 Erreur du serveur Problème principal temporaire ou erreur inattendue.

résolution des problèmes

  1. Vérifiez que la valeur d’autorisation utilise le format exact apikey YOUR_API_KEY .
  2. Vérifiez que les champs obligatoires sont présents et valides.
  3. Pour Créer un journal d’heure, vérifiez queduration vous avez passéou (start et end).

Journal des modifications

  • 1.0.0 : soumission initiale pour la certification.

Support

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Authorization securestring Autorisation pour cette API Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Ajouter une tâche au projet

Créez une tâche sur un projet sélectionné.
Créer un client

Créez un enregistrement client.
Créer un journal d’heure

Créez un journal de temps. Le champ « duration » ou les champs « heure de début » et « heure de fin » doivent être renseignés. En cas de remplissage des trois, vous obtiendrez une erreur
Créer un projet

Créez un projet.
Créer une balise

Créez une balise.
Obtenir les journaux d’activité de temps

Obtenez des journaux d’activité ou d’heure détaillés pour une plage de dates.
Rechercher le client par nom

Retourne les clients qui correspondent au nom fourni.
Rechercher un projet par nom

Recherchez un projet par nom.
Rechercher une balise par nom

Recherchez une balise par son nom.
Rechercher une tâche par nom

Recherchez une tâche de projet par nom et ID de projet.

Ajouter une tâche au projet

ID d’opération :
CreateProjectTask

Créez une tâche sur un projet sélectionné.

Paramètres

Nom Clé Obligatoire Type Description
ID Projet
 projectId True integer

ID de projet.
Nom de la liste
 listName string

Nom de la liste des tâches.
Nom
 name True string

Nom de la tâche.
Descriptif
 description string

Description.

Retours

Corps
ProjectTask

Créer un client

ID d’opération :
CreateClient

Créez un enregistrement client.

Paramètres

Nom Clé Obligatoire Type Description
Nom
 Name True string

Nom du client.

Retours

Corps
Client

Créer un journal d’heure

ID d’opération :
CreateLog

Créez un journal de temps. Le champ « duration » ou les champs « heure de début » et « heure de fin » doivent être renseignés. En cas de remplissage des trois, vous obtiendrez une erreur

Paramètres

Nom Clé Obligatoire Type Description
Date
 date True date

Date au format AAAA -MM-DD.
Heure de début
 start date-time

Heure de début au format UTC ou ISO 8601 local.
Heure de fin
 end date-time

Heure de fin au format UTC ou ISO 8601 local.
Durée
 duration integer

Durée en secondes.
Descriptif
 Note string

Note.
ID Projet
 ProjectId integer

ID de projet.
ID de tâche
 TaskId integer

ID de tâche.
ID de balise
 TagId integer

ID de balise.

Retours

Corps
TimeLog

Créer un projet

ID d’opération :
CreateProject

Créez un projet.

Paramètres

Nom Clé Obligatoire Type Description
Nom
 name True string

Nom du projet.
ID de client
 clientId integer

ID client.
Remarques
 notes string

Notes.
Utilisateur affecté
 autoAssignUserId integer

Utilisateur affecté au projet.

Retours

Corps
Project

Créer une balise

ID d’opération :
CreateTag

Créez une balise.

Paramètres

Nom Clé Obligatoire Type Description
Nom de la balise
 name True string

Nom de la balise.
Couleur hexadécimal
 hexColor True string

Couleur hexadécimal dans

Retours

Corps
Tag

Obtenir les journaux d’activité de temps

ID d’opération :
GetTimeLogs

Obtenez des journaux d’activité ou d’heure détaillés pour une plage de dates.

Paramètres

Nom Clé Obligatoire Type Description
Date à partir de
 dateFrom True date

Date de début au format AAAA-MM-DD.
Date à
 dateTo True date

Date de fin au format AAAA-MM-DD.

Retours

Corps
ActivityReportResponse

Rechercher le client par nom

ID d’opération :
FindClient

Retourne les clients qui correspondent au nom fourni.

Paramètres

Nom Clé Obligatoire Type Description
Nom du client
 clientName True string

Nom du client avec correspondance exacte ou partielle.

Retours

response
array of Client

Rechercher un projet par nom

ID d’opération :
FindProject

Recherchez un projet par nom.

Paramètres

Nom Clé Obligatoire Type Description
Nom du projet
 projectName True string

Nom du projet.

Retours

Corps
Project

Rechercher une balise par nom

ID d’opération :
FindTag

Recherchez une balise par son nom.

Paramètres

Nom Clé Obligatoire Type Description
Nom de la balise
 tagName True string

Nom de la balise.

Retours

Corps
Tag

Rechercher une tâche par nom

ID d’opération :
FindTask

Recherchez une tâche de projet par nom et ID de projet.

Paramètres

Nom Clé Obligatoire Type Description
Nom de la tâche
 projectTaskName True string

Nom de la tâche.
ID Projet
 projectId True integer

ID de projet.

Retours

Corps
ProjectTask

Déclencheurs

Lors de la création d’un journal d’heure

Déclencher lorsqu’un nouveau journal d’heure est créé.
Lors de la création d’un projet

Déclencher lorsqu’un nouveau projet est créé.
Lors de la création d’une tâche

Déclencher lorsqu’une tâche de projet est créée.

Lors de la création d’un journal d’heure

ID d’opération :
NewTimeLog

Déclencher lorsqu’un nouveau journal d’heure est créé.

Retours

Corps
TriggerLogsEnvelope

Lors de la création d’un projet

ID d’opération :
NewProject

Déclencher lorsqu’un nouveau projet est créé.

Retours

Corps
TriggerProjectsEnvelope

Lors de la création d’une tâche

ID d’opération :
NewTask

Déclencher lorsqu’une tâche de projet est créée.

Retours

Corps
TriggerProjectTasksEnvelope

Définitions

TimeSlice

Nom Chemin d’accès Type Description
pièce d'identité
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
course
 running boolean
supprimé
 deleted boolean

Pièce jointe

Nom Chemin d’accès Type Description
fileName
 fileName string
fileUrl
 fileUrl string
pièce d'identité
 id integer

Tag

Nom Chemin d’accès Type Description
nom
 name string
hexColor
 hexColor string
Archivés
 archived boolean
dateArchived
 dateArchived string
pièce d'identité
 id integer

Client

Nom Chemin d’accès Type Description
nom
 name string
contactName
 contactName string
contactEmail
 contactEmail string
contactTéléphone
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
pièce d'identité
 id integer

Projet

Nom Chemin d’accès Type Description
invoiceMethod
 invoiceMethod integer
taux
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
Remarques
 notes string
approuvé
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
date de début
 startDate string
dueDate
 dueDate string
dateCreated
 dateCreated string
createdByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
Facturable
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
nom
 name string
Archivés
 archived boolean
customId
 customId string
pièce d'identité
 id integer

ProjectTask

Nom Chemin d’accès Type Description
nom
 name string
orderNo
 orderNo integer
descriptif
 description string
terminé
 completed boolean
Archivés
 archived boolean
date de début
 startDate string
dueDate
 dueDate string
taux
 rate float
billableByDefault
 billableByDefault boolean
budgetValue
 budgetValue float
budgetSpent
 budgetSpent float
budgetSpentPercentage
 budgetSpentPercentage float
projectBudgetType
 projectBudgetType integer
projectTaskUserIds
 projectTaskUserIds array of integer
customFieldValues
 customFieldValues string
customId
 customId string
projectCustomId
 projectCustomId string
clientCustomId
 clientCustomId string
pièce d'identité
 id integer

TimeLog

Nom Chemin d’accès Type Description
note
 note string
date
 date string
duration
 duration integer
nom d’utilisateur
 userName string
nom_projet
 projectName string
taskName
 taskName string
clientName
 clientName string
course
 running boolean
startTime
 startTime string
endTime
 endTime string
fois
 times array of TimeSlice
status
 status integer
projectId
 projectId integer
taskId
 taskId integer
Facturable
 billable boolean
dépense
 expense float
userId
 userId integer
factableRate
 billableRate float
factableAmount
 billableAmount float
laborRate
 laborRate float
laborCost
 laborCost float
customField1Name
 customField1Name string
customField2Name
 customField2Name string
customField3Name
 customField3Name string
customField1Value
 customField1Value string
customField2Value
 customField2Value string
customField3Value
 customField3Value string
tags
 tags string
durationInHours
 durationInHours float
pièce d'identité
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Nom Chemin d’accès Type Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
nom d’utilisateur
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
nom_projet
 projectName string
projectCustomId
 projectCustomId string
projectStartDate
 projectStartDate string
projectDueDate
 projectDueDate string
projectBudgetType
 projectBudgetType string
projectBudgetTarget
 projectBudgetTarget string
projectBudgetPeriodType
 projectBudgetPeriodType string
projectBudgetValue
 projectBudgetValue integer
taskListName
 taskListName string
taskId
 taskId integer
taskName
 taskName string
taskCustomId
 taskCustomId string
taskStartDate
 taskStartDate string
taskDueDate
 taskDueDate string
taskCompleted
 taskCompleted boolean
userCustomFieldValues
 userCustomFieldValues string
projectCustomFieldValues
 projectCustomFieldValues string
clientCustomFieldValues
 clientCustomFieldValues string
taskCustomFieldValues
 taskCustomFieldValues string
tags
 tags string
taux
 rate float
Facturable
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
factableAmount
 billableAmount float
quantité
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
dépense
 expense float
billableExpense
 billableExpense float
coût
 cost float
note
 note string
status
 status string
Id. de facturation
 invoiceId integer
Facturés
 invoiced boolean
factableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
balance
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
Teams
 teams array of string
course
 running boolean
startTime
 startTime string
endTime
 endTime string
fois
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
roundType
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

ActivityReportResponse

Nom Chemin d’accès Type Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Nom Chemin d’accès Type Description
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Nom Chemin d’accès Type Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
nom
 projects.name string
customId
 projects.customId string
pièce d'identité
 projects.id integer

TriggerProjectTasksEnvelope

Nom Chemin d’accès Type Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
nom
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
descriptif
 projectTasks.description string
taux
 projectTasks.rate float
budgetValue
 projectTasks.budgetValue float
projectBudgetType
 projectTasks.projectBudgetType integer
customId
 projectTasks.customId string
billableByDefault
 projectTasks.billableByDefault boolean
projectCustomId
 projectTasks.projectCustomId string
clientCustomId
 projectTasks.clientCustomId string
pièce d'identité
 projectTasks.id integer