Condividi tramite

Ore personali (anteprima)

Tenere traccia del tempo e gestire progetti, attività, client e tag con selezione dinamica. Questo connettore espone gli endpoint per la creazione e la ricerca di entità.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Ore personali
URL https://myhours.com
Email support@myhours.com
Metadati del connettore
Editore Spica International
Sito Web https://myhours.com
Informativa sulla privacy https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Categorie Produttività

My Hours - Introduzione al connettore

Tenere traccia del tempo e gestire progetti, attività, client e tag usando il connettore My Hours.

Authentication

Digitare: Chiave API (intestazione)

Quando si crea una connessione, immettere il valore completo nel singolo campo denominato Authorization usando questo formato esatto:

Esempio: apikey 123abcXYZ

Il connettore invia questo valore come Authorization intestazione in ogni richiesta.

Dove ottenere la chiave: Dalle impostazioni dell'account Ore personali. Creare o copiare una chiave API. Mantenerlo segreto e ruotarlo se esposto.

Azioni supportate

  • Crea client : creare un nuovo client.
  • Trovare Client per nome : restituisce i client che corrispondono al nome specificato.
  • Crea progetto : crea un nuovo progetto.
  • Trova progetto per nome : trova un progetto in base al nome.
  • Aggiungi attività a progetto : crea un'attività in un progetto selezionato.
  • Trova attività per nome : trovare un'attività di progetto in base al nome e all'ID progetto.
  • Crea tag : crea un nuovo tag (con colore esadecimale).
  • Trova tag per nome : trova un tag in base al nome.
  • Crea log ora : creare un nuovo log ora.
  • Recupera log ora : recuperare i log di attività/ora dettagliati per un intervallo di date.

Trigger supportati

  • Quando viene creato un nuovo progetto : viene generato quando viene visualizzato un nuovo progetto.
  • Quando viene creata una nuova attività : viene attivata quando viene visualizzata una nuova attività di progetto.
  • Quando viene creato un nuovo log ora : viene generato quando viene visualizzato un nuovo log ora.

Note e limiti di utilizzo

  • Formato di autorizzazione : la connessione richiede il prefisso apikey letterale seguito dalla chiave. Se si omette il prefisso o si aggiungono caratteri aggiuntivi, le richieste potrebbero non riuscire con 400 o 401.
  • Formati di data/ora : le date sono AAAA-MM-GG. I valori di data/ora sono ISO 8601 (ad esempio 2025-09-05T08:30:00Z o un offset locale).
  • Creazione dei log temporali: specificareduration (secondi) o entrambi start e end. Specificare tutti e tre gli elementi non validi.
  • Selezione dinamica : i campi Progetto, Attività, Tag e Utente usano elenchi dinamici; assicurarsi che l'account disponga dell'autorizzazione per leggere tali entità o che gli elenchi siano vuoti.
  • Ambiente : è supportato solo l'host DELL'API di produzione: https://api2.myhours.com.

Gestione degli errori

Il connettore restituisce codici di stato HTTP standard:

Codice Meaning Cause tipiche
200 Success Operazioni di lettura/elenco.
201 Created Operazioni di creazione riuscite.
400 Richiesta non valida Input mancanti/non validi, formato di intestazione errato, campi corpo in conflitto.
500 Errore del server Problema back-end temporaneo o errore imprevisto.

Risoluzione dei problemi

  1. Verificare che il valore authorization usi il formato esatto apikey YOUR_API_KEY .
  2. Verificare che i campi obbligatori siano presenti e validi.
  3. Per Create Time Log (Crea log ora) verificare che sia statopassato durationo (start e end).

Log delle modifiche

  • 1.0.0 - Invio iniziale per la certificazione.

Support

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:
Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Authorization securestring Autorizzazione per questa API Vero

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Aggiungi attività al progetto

Creare un'attività in un progetto selezionato.
Crea progetto

Creare un nuovo progetto.
Crea tag

Creare un nuovo tag.
Creare un client

Creare un nuovo record client.
Creare un log ora

Creare un log ora. Il campo 'duration' o i campi 'start time' e 'end time' devono essere compilati. In caso di riempimento di tutti e tre, si riceverà un errore
Ottenere i log ora

Ottenere log di attività o ora dettagliati per un intervallo di date.
Trova attività in base al nome

Trovare un'attività di progetto in base al nome e all'ID progetto.
Trova tag per nome

Trovare un tag in base al nome.
Trovare client in base al nome

Restituisce i client che corrispondono al nome specificato.
Trovare il progetto in base al nome

Trovare un progetto in base al nome.

Aggiungi attività al progetto

ID operazione:
CreateProjectTask

Creare un'attività in un progetto selezionato.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID del progetto
 projectId True integer

ID progetto.
Nome della lista
 listName string

Nome elenco attività.
Nome
 name True string

Nome attività.
Description
 description string

Description.

Restituisce

Corpo
ProjectTask

Crea progetto

ID operazione:
CreateProject

Creare un nuovo progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome
 name True string

Nome progetto.
ID cliente
 clientId integer

ID client
Note
 notes string

Note.
Utente assegnato
 autoAssignUserId integer

Utente assegnato al progetto.

Restituisce

Corpo
Project

Crea tag

ID operazione:
CreateTag

Creare un nuovo tag.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome tag
 name True string

Nome tag.
Colore esadecimale
 hexColor True string

Colore esadecimale in

Restituisce

Corpo
Tag

Creare un client

ID operazione:
CreateClient

Creare un nuovo record client.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome
 Name True string

Nome client.

Restituisce

Corpo
Client

Creare un log ora

ID operazione:
CreateLog

Creare un log ora. Il campo 'duration' o i campi 'start time' e 'end time' devono essere compilati. In caso di riempimento di tutti e tre, si riceverà un errore

Parametri

Nome Chiave Necessario Tipo Descrizione
Date
 date True date

Data in formato AAAA-MM-DD.
Ora di avvio
 start date-time

Ora di inizio in formato UTC o ISO 8601 locale.
Ora di fine
 end date-time

Ora di fine in formato UTC o ISO 8601 locale.
Durata
 duration integer

Durata in secondi.
Description
 Note string

Nota.
ID del progetto
 ProjectId integer

ID progetto.
ID attività
 TaskId integer

ID attività.
Tag ID
 TagId integer

ID tag.

Restituisce

Corpo
TimeLog

Ottenere i log ora

ID operazione:
GetTimeLogs

Ottenere log di attività o ora dettagliati per un intervallo di date.

Parametri

Nome Chiave Necessario Tipo Descrizione
Data da
 dateFrom True date

Data di inizio in formato AAAA-MM-DD.
Da data a
 dateTo True date

Data di fine in formato AAAA-MM-DD.

Restituisce

Corpo
ActivityReportResponse

Trova attività in base al nome

ID operazione:
FindTask

Trovare un'attività di progetto in base al nome e all'ID progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome attività
 projectTaskName True string

Nome attività.
ID del progetto
 projectId True integer

ID progetto.

Restituisce

Corpo
ProjectTask

Trova tag per nome

ID operazione:
FindTag

Trovare un tag in base al nome.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome tag
 tagName True string

Nome tag.

Restituisce

Corpo
Tag

Trovare client in base al nome

ID operazione:
FindClient

Restituisce i client che corrispondono al nome specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome del client
 clientName True string

Nome client con corrispondenza esatta o parziale.

Restituisce

response
array of Client

Trovare il progetto in base al nome

ID operazione:
FindProject

Trovare un progetto in base al nome.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome progetto
 projectName True string

Nome progetto.

Restituisce

Corpo
Project

Trigger

Quando viene creata una nuova attività

Attivare quando viene creata una nuova attività di progetto.
Quando viene creato un nuovo log ora

Attivare quando viene creato un nuovo log ora.
Quando viene creato un nuovo progetto

Attivare quando viene creato un nuovo progetto.

Quando viene creata una nuova attività

ID operazione:
NewTask

Attivare quando viene creata una nuova attività di progetto.

Restituisce

Corpo
TriggerProjectTasksEnvelope

Quando viene creato un nuovo log ora

ID operazione:
NewTimeLog

Attivare quando viene creato un nuovo log ora.

Restituisce

Corpo
TriggerLogsEnvelope

Quando viene creato un nuovo progetto

ID operazione:
NewProject

Attivare quando viene creato un nuovo progetto.

Restituisce

Corpo
TriggerProjectsEnvelope

Definizioni

TimeSlice

Nome Percorso Tipo Descrizione
id
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
in esecuzione
 running boolean
cancellato
 deleted boolean

Attachment

Nome Percorso Tipo Descrizione
fileName
 fileName string
fileUrl
 fileUrl string
id
 id integer

Tag

Nome Percorso Tipo Descrizione
nome
 name string
hexColor
 hexColor string
Archiviati
 archived boolean
dateArchived
 dateArchived string
id
 id integer

Cliente

Nome Percorso Tipo Descrizione
nome
 name string
contactName
 contactName string
contattoEmail
 contactEmail string
contattoTelefono
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
id
 id integer

Progetto

Nome Percorso Tipo Descrizione
invoiceMethod
 invoiceMethod integer
tasso
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
note
 notes string
approvato
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
DueDate
 dueDate string
dateCreated
 dateCreated string
createdByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
fatturabile
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
nome
 name string
Archiviati
 archived boolean
customId
 customId string
id
 id integer

ProjectTask

Nome Percorso Tipo Descrizione
nome
 name string
orderNo
 orderNo integer
descrizione
 description string
completato
 completed boolean
Archiviati
 archived boolean
startDate
 startDate string
DueDate
 dueDate string
tasso
 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
id
 id integer

TimeLog

Nome Percorso Tipo Descrizione
nota
 note string
date
 date string
duration
 duration integer
nome utente
 userName string
Nome progetto
 projectName string
taskName
 taskName string
clientName
 clientName string
in esecuzione
 running boolean
startTime
 startTime string
endTime
 endTime string
tempi
 times array of TimeSlice
status
 status integer
projectId
 projectId integer
taskId
 taskId integer
fatturabile
 billable boolean
spesa
 expense float
userId
 userId integer
fatturabileRate
 billableRate float
billableAmount
 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
id
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Nome Percorso Tipo Descrizione
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
nome utente
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
Nome progetto
 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
tasso
 rate float
fatturabile
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
importo
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
spesa
 expense float
billableExpense
 billableExpense float
costo
 cost float
nota
 note string
status
 status string
ID Fattura
 invoiceId integer
fatturato
 invoiced boolean
billableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
bilancia
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
Squadre
 teams array of string
in esecuzione
 running boolean
startTime
 startTime string
endTime
 endTime string
tempi
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
roundType
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

ActivityReportResponse

Nome Percorso Tipo Descrizione
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Nome Percorso Tipo Descrizione
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Nome Percorso Tipo Descrizione
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
nome
 projects.name string
customId
 projects.customId string
id
 projects.id integer

TriggerProjectTasksEnvelope

Nome Percorso Tipo Descrizione
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
nome
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
descrizione
 projectTasks.description string
tasso
 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
id
 projectTasks.id integer