Partilhar via

Minhas Horas (Visualização)

Acompanhe o tempo e gerencie projetos, tarefas, clientes e tags com seletores dinâmicos. Este conector expõe pontos de extremidade para criar e localizar entidades.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Minhas Horas
URL https://myhours.com
Email support@myhours.com
Metadados do conector
Editora Aeroporto Internacional de Spica
Sítio Web https://myhours.com
Política de privacidade https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Categorias Produtividade

Minhas horas - Introdução ao conector

Controle o tempo e gerencie projetos, tarefas, clientes e tags usando o conector Minhas Horas.

Authentication

Tipo: Chave API (cabeçalho)

Ao criar uma conexão, insira o valor completo no único campo chamado Autorização usando este formato exato:

Exemplo: apikey 123abcXYZ

O conector envia esse valor como o Authorization cabeçalho em cada solicitação.

Onde obter a chave: A partir das definições da sua conta As Minhas Horas. Crie ou copie uma chave de API. Mantenha-o em segredo e gire-o se exposto.

Ações suportadas

  • Criar cliente – Crie um novo cliente.
  • Localizar cliente por nome – Retorna clientes que correspondem ao nome fornecido.
  • Criar projeto – Crie um novo projeto.
  • Localizar projeto por nome – Encontre um projeto por nome.
  • Adicionar tarefa ao projeto – Crie uma tarefa em um projeto selecionado.
  • Localizar tarefa por nome – Encontre uma tarefa de projeto por nome e ID do projeto.
  • Criar tag – Crie uma nova tag (com cor hexadecimal).
  • Localizar etiqueta por nome – Encontre uma etiqueta por nome.
  • Criar registro de tempo – Crie um novo registro de tempo.
  • Obter Registos de Tempo – Recupere registos de atividade/hora detalhados para um intervalo de datas.

Gatilhos suportados

  • Quando um novo projeto é criado – Aciona quando um novo projeto aparece.
  • Quando uma nova Tarefa é criada – É acionada quando uma nova tarefa do projeto é exibida.
  • Quando um novo registro de tempo é criado – é acionado quando um novo registro de tempo aparece.

Notas de uso e limites

  • Formato de autorização – A conexão requer o prefixo apikey literal seguido da sua chave. Se você omitir o prefixo ou adicionar caracteres extras, as solicitações podem falhar com 400 ou 401.
  • Formatos de data/hora – As datas são AAAA-MM-DD. Os valores de data/hora são ISO 8601 (por exemplo, 2025-09-05T08:30:00Z ou um deslocamento local).
  • Criação de registros de tempo – Forneça (duration segundos) ou ambos start e end. O fornecimento dos três é inválido.
  • Seletores dinâmicos – os campos Projeto, Tarefa, Tag e Usuário usam listas dinâmicas; Certifique-se de que a sua conta tem permissão para ler essas entidades ou as listas podem estar vazias.
  • Ambiente – Somente o host da API de produção é suportado: https://api2.myhours.com.

Tratamento de erros

O conector retorna códigos de status HTTP padrão:

Código Meaning Causas típicas
200 Sucesso Operações de leitura/lista.
201 Criado Operações de criação bem-sucedidas.
400 Pedido inválido Entradas ausentes/inválidas, formato de cabeçalho errado, campos de corpo conflitantes.
500 Erro do servidor Problema temporário de back-end ou erro inesperado.

Troubleshooting

  1. Verifique se o valor Authorization usa o formato exato apikey YOUR_API_KEY .
  2. Verifique se os campos obrigatórios estão presentes e são válidos.
  3. Para Criar Registo de Tempo,confirme que passou duration (start e end).

Registo de alterações

  • 1.0.0 – Submissão inicial para certificação.

Support

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Authorization securestring A autorização para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Adicionar tarefa ao projeto

Crie uma tarefa em um projeto selecionado.
Criar Cliente

Crie um novo registro de cliente.
Criar projeto

Crie um novo projeto.
Criar registo de horas

Crie um registro de tempo. Devem ser preenchidos os campos «duração» ou «hora de início» e «hora de fim». No caso de todos os três serem preenchidos, você receberá um erro
Criar tag

Crie uma nova tag.
Encontrar cliente por nome

Retornar clientes que correspondam ao nome fornecido.
Encontrar projeto por nome

Encontre um projeto pelo nome.
Localizar tag por nome

Encontre uma tag pelo nome.
Localizar tarefa por nome

Encontre uma tarefa de projeto por nome e ID do projeto.
Obter registros de tempo

Obtenha registros detalhados de atividades ou horários para um intervalo de datas.

Adicionar tarefa ao projeto

ID da Operação:
CreateProjectTask

Crie uma tarefa em um projeto selecionado.

Parâmetros

Name Chave Necessário Tipo Description
ID do projeto
 projectId True integer

ID do projeto.
Nome da lista
 listName string

Nome da lista de tarefas.
Nome
 name True string

Nome da tarefa.
Description
 description string

Description.

Devoluções

Body
ProjectTask

Criar Cliente

ID da Operação:
CreateClient

Crie um novo registro de cliente.

Parâmetros

Name Chave Necessário Tipo Description
Nome
 Name True string

Nome do cliente.

Devoluções

Body
Client

Criar projeto

ID da Operação:
CreateProject

Crie um novo projeto.

Parâmetros

Name Chave Necessário Tipo Description
Nome
 name True string

Nome do projeto.
ID do Cliente
 clientId integer

ID de Cliente.
Observações
 notes string

Observações.
Usuário atribuído
 autoAssignUserId integer

Usuário atribuído ao projeto.

Devoluções

Body
Project

Criar registo de horas

ID da Operação:
CreateLog

Crie um registro de tempo. Devem ser preenchidos os campos «duração» ou «hora de início» e «hora de fim». No caso de todos os três serem preenchidos, você receberá um erro

Parâmetros

Name Chave Necessário Tipo Description
Date
 date True date

Data no formato AAAA-MM-DD.
Hora de início
 start date-time

Hora de início no formato UTC ou ISO 8601 local.
Hora de fim
 end date-time

Hora de fim no formato UTC ou ISO 8601 local.
Duração
 duration integer

Duração em segundos.
Description
 Note string

Observação.
ID do projeto
 ProjectId integer

ID do projeto.
ID da tarefa
 TaskId integer

ID da tarefa.
ID da etiqueta
 TagId integer

ID da etiqueta.

Devoluções

Body
TimeLog

Criar tag

ID da Operação:
CreateTag

Crie uma nova tag.

Parâmetros

Name Chave Necessário Tipo Description
Nome da etiqueta
 name True string

Nome da tag.
Cor hexadecimal
 hexColor True string

Cor hexadecimal em

Devoluções

Body
Tag

Encontrar cliente por nome

ID da Operação:
FindClient

Retornar clientes que correspondam ao nome fornecido.

Parâmetros

Name Chave Necessário Tipo Description
Nome do cliente
 clientName True string

Nome do cliente com correspondência exata ou parcial.

Devoluções

response
array of Client

Encontrar projeto por nome

ID da Operação:
FindProject

Encontre um projeto pelo nome.

Parâmetros

Name Chave Necessário Tipo Description
Nome do projeto
 projectName True string

Nome do projeto.

Devoluções

Body
Project

Localizar tag por nome

ID da Operação:
FindTag

Encontre uma tag pelo nome.

Parâmetros

Name Chave Necessário Tipo Description
Nome da etiqueta
 tagName True string

Nome da tag.

Devoluções

Body
Tag

Localizar tarefa por nome

ID da Operação:
FindTask

Encontre uma tarefa de projeto por nome e ID do projeto.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tarefa
 projectTaskName True string

Nome da tarefa.
ID do projeto
 projectId True integer

ID do projeto.

Devoluções

Body
ProjectTask

Obter registros de tempo

ID da Operação:
GetTimeLogs

Obtenha registros detalhados de atividades ou horários para um intervalo de datas.

Parâmetros

Name Chave Necessário Tipo Description
Data de
 dateFrom True date

Data de início no formato AAAA-MM-DD.
Data para
 dateTo True date

Data de fim no formato AAAA-MM-DD.

Devoluções

Body
ActivityReportResponse

Acionadores

Quando um novo projeto é criado

Acionar quando um novo projeto é criado.
Quando um novo Registo de Horas é criado

Acionar quando um novo log de tempo é criado.
Quando uma nova Tarefa é criada

Acionar quando uma nova tarefa de projeto é criada.

Quando um novo projeto é criado

ID da Operação:
NewProject

Acionar quando um novo projeto é criado.

Devoluções

Body
TriggerProjectsEnvelope

Quando um novo Registo de Horas é criado

ID da Operação:
NewTimeLog

Acionar quando um novo log de tempo é criado.

Devoluções

Body
TriggerLogsEnvelope

Quando uma nova Tarefa é criada

ID da Operação:
NewTask

Acionar quando uma nova tarefa de projeto é criada.

Devoluções

Body
TriggerProjectTasksEnvelope

Definições

TimeSlice

Name Caminho Tipo Description
id
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
a correr
 running boolean
Suprimido
 deleted boolean

Attachment

Name Caminho Tipo Description
fileName
 fileName string
fileUrl
 fileUrl string
id
 id integer

Tag

Name Caminho Tipo Description
nome
 name string
hexColor
 hexColor string
arquivado
 archived boolean
dateArquivado
 dateArchived string
id
 id integer

Client

Name Caminho Tipo Description
nome
 name string
nomedocontato
 contactName string
contatoE-mail
 contactEmail string
contatoTelefone
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
id
 id integer

Projeto

Name Caminho Tipo Description
invoiceMethod
 invoiceMethod integer
taxa
 rate float
Tipo de orçamento
 budgetType integer
orçamentoValor
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
Observações
 notes string
Aprovado
 approved boolean
Tipo redondo
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
orçamentoTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
data de vencimento
 dueDate string
dateCriado
 dateCreated string
criadoByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
faturável
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
nome_do_cliente
 clientName string
clientCustomId
 clientCustomId string
nome
 name string
arquivado
 archived boolean
customId
 customId string
id
 id integer

ProjectTask

Name Caminho Tipo Description
nome
 name string
Nº de ordem
 orderNo integer
descrição
 description string
concluída
 completed boolean
arquivado
 archived boolean
startDate
 startDate string
data de vencimento
 dueDate string
taxa
 rate float
billableByDefault
 billableByDefault boolean
orçamentoValor
 budgetValue float
orçamentoGasto
 budgetSpent float
orçamentoPercentagem de gastos
 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

Name Caminho Tipo Description
Observação
 note string
date
 date string
duration
 duration integer
nome de utilizador
 userName string
nome_do_projeto
 projectName string
Nome da tarefa
 taskName string
nome_do_cliente
 clientName string
a correr
 running boolean
startTime
 startTime string
endTime
 endTime string
vezes
 times array of TimeSlice
estado
 status integer
projectId
 projectId integer
taskId
 taskId integer
faturável
 billable boolean
despesa
 expense float
userId
 userId integer
faturávelRate
 billableRate float
faturávelMontante
 billableAmount float
Taxa de trabalho
 laborRate float
mão-de-obraCusto
 laborCost float
customField1Name
 customField1Name string
customField2Name
 customField2Name string
customField3Name
 customField3Name string
customField1Value
 customField1Value string
customField2Value
 customField2Value string
customField3Value
 customField3Value string
tags
 tags string
duraçãoInHours
 durationInHours float
id
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name Caminho Tipo Description
ID de login
 logId integer
userId
 userId integer
date
 date string
equipasNomes
 teamsNames string
nome de utilizador
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
nome_do_cliente
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
nome_do_projeto
 projectName string
projectCustomId
 projectCustomId string
projectStartDate
 projectStartDate string
projetoDueDate
 projectDueDate string
projectBudgetType
 projectBudgetType string
projectBudgetTarget
 projectBudgetTarget string
projectBudgetPeriodType
 projectBudgetPeriodType string
projectBudgetValue
 projectBudgetValue integer
taskListName
 taskListName string
taskId
 taskId integer
Nome da tarefa
 taskName string
taskCustomId
 taskCustomId string
taskStartDate
 taskStartDate string
taskDueDate
 taskDueDate string
tarefaConcluída
 taskCompleted boolean
userCustomFieldValues
 userCustomFieldValues string
projectCustomFieldValues
 projectCustomFieldValues string
clientCustomFieldValues
 clientCustomFieldValues string
taskCustomFieldValues
 taskCustomFieldValues string
tags
 tags string
taxa
 rate float
faturável
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
faturávelMontante
 billableAmount float
Montante
 amount float
mão-de-obraCusto
 laborCost float
Taxa de trabalho
 laborRate float
logDuração
 logDuration integer
logDurationFaturável
 logDurationBillable integer
laborDuração
 laborDuration integer
startEndTime
 startEndTime string
despesa
 expense float
faturávelDespesa
 billableExpense float
custo
 cost float
Observação
 note string
estado
 status string
ID da Fatura
 invoiceId integer
faturado
 invoiced boolean
faturávelHoras
 billableHours integer
faturávelHorasLogFaturável
 billableHoursLogBillable integer
Horário de trabalho
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
saldo
 balance integer
mêsdoAno
 monthOfYear string
semanaNo
 weekNo integer
weekOfYear
 weekOfYear string
Equipas
 teams array of string
a correr
 running boolean
startTime
 startTime string
endTime
 endTime string
vezes
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
Tipo redondo
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

Relatório de AtividadesResposta

Name Caminho Tipo Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name Caminho Tipo Description
registos
 logs array of TimeLog

TriggerProjectsEnvelope

Name Caminho Tipo Description
projects
 projects array of object
clientId
 projects.clientId integer
nome_do_cliente
 projects.clientName string
clientCustomId
 projects.clientCustomId string
nome
 projects.name string
customId
 projects.customId string
id
 projects.id integer

TriggerProjectTasksEnvelope

Name Caminho Tipo Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
nome
 projectTasks.name string
Nº de ordem
 projectTasks.orderNo integer
descrição
 projectTasks.description string
taxa
 projectTasks.rate float
orçamentoValor
 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