Поделиться через

Мои часы (предварительная версия)

Отслеживайте время и управляйте проектами, задачами, клиентами и тегами с помощью динамических средства выбора. Этот соединитель предоставляет конечные точки для создания и поиска сущностей.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Мои часы
URL https://myhours.com
Адрес электронной почты support@myhours.com
Метаданные соединителя
Publisher Спайка Интернешнл
Веб-сайт https://myhours.com
Политика конфиденциальности https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Категории Продуктивность

Мои часы — общие сведения о соединителе

Отслеживайте время и управляйте проектами, задачами, клиентами и тегами с помощью соединителя "Мои часы".

Authentication

Тип: Ключ API (заголовок)

При создании подключения введите полное значение в одном поле с именем Authorization с помощью этого точного формата:

Пример: apikey 123abcXYZ

Соединитель отправляет это значение в качестве заголовка по каждому запросу Authorization .

Где получить ключ: Из параметров учетной записи "Мои часы". Создайте или скопируйте ключ API. Сохраните секрет и измените его, если он предоставлен.

Поддерживаемые действия

  • Создание клиента — создание нового клиента.
  • Поиск клиента по имени — возврат клиентов, которые соответствуют указанному имени.
  • Создание проекта — создание нового проекта.
  • Поиск проекта по имени— поиск проекта по имени.
  • Добавление задачи в проект — создание задачи в выбранном проекте.
  • Поиск задачи по имени— поиск задачи проекта по имени и идентификатору проекта.
  • Создание тега — создание нового тега (с шестнадцатеричным цветом).
  • Поиск тега по имени — поиск тега по имени.
  • Создание журнала времени — создание нового журнала времени.
  • Получение журналов времени — получение подробных журналов действий и времени для диапазона дат.

Поддерживаемые триггеры

  • При создании нового проекта — возникает ошибка при появлении нового проекта.
  • При создании новой задачи — возникает ошибка при появлении новой задачи проекта.
  • При создании нового журнала времени — запускается при появлении нового журнала времени.

Заметки об использовании и ограничения

  • Формат авторизации . Для подключения требуется префикс apikey литерала, за которым следует ключ. Если префикс или добавить дополнительные символы, запросы могут завершиться ошибкой 400 или 401.
  • Форматы даты и времени — даты ггГГ-ММ-ДД. Значения даты и времени — ISO 8601 (например 2025-09-05T08:30:00Z , локальное смещение).
  • Создание журналов времени— укажите либо (секунды), либоduration оба start и.end Предоставление всех трех недопустимых.
  • Динамические средства выбора — поля "Проект", "Задача", "Тег" и "Пользователь" используют динамические списки; Убедитесь, что у вашей учетной записи есть разрешение на чтение этих сущностей или списков может быть пустым.
  • Среда — поддерживается только рабочий узел API: https://api2.myhours.com

Обработка ошибок

Соединитель возвращает стандартные коды состояния HTTP:

Code Meaning Типичные причины
200 Success Операции чтения и списка.
201 Создано Успешные операции создания.
400 Недопустимый запрос Отсутствующие или недопустимые входные данные, неправильный формат заголовка, конфликтующие поля текста.
500 Ошибка сервера Временная проблема серверной части или непредвиденная ошибка.

Troubleshooting

  1. Убедитесь, что значение авторизации использует точный apikey YOUR_API_KEY формат.
  2. Проверьте наличие и допустимость обязательных полей.
  3. Для создания журнала времени убедитесь, что вы прошли либоduration(иstartend).

Журнал изменений

  • 1.0.0 — начальная отправка для сертификации.

Support

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Authorization securestring Авторизация для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Добавление задачи в проект

Создайте задачу в выбранном проекте.
Поиск задачи по имени

Найдите задачу проекта по имени и идентификатору проекта.
Поиск клиента по имени

Возвращает клиенты, соответствующие указанному имени.
Поиск проекта по имени

Найдите проект по имени.
Поиск тега по имени

Найдите тег по его имени.
Получение журналов времени

Получение подробных журналов действий или журналов времени для диапазона дат.
Создание журнала времени

Создайте журнал времени. Поле "длительность" или поля "время начала" и "время окончания" должны быть заполнены. В случае всех трех заполнений вы получите ошибку
Создание клиента

Создайте новую запись клиента.
Создать проект

Создание проекта
Создать тег

Создайте новый тег.

Добавление задачи в проект

Идентификатор операции:
CreateProjectTask

Создайте задачу в выбранном проекте.

Параметры

Имя Ключ Обязательно Тип Описание
Код проекта
 projectId True integer

Идентификатор проекта.
Имя списка
 listName string

Имя списка задач.
Имя
 name True string

Имя задачи.
Description
 description string

Description.

Возвращаемое значение

Тело
ProjectTask

Поиск задачи по имени

Идентификатор операции:
FindTask

Найдите задачу проекта по имени и идентификатору проекта.

Параметры

Имя Ключ Обязательно Тип Описание
Имя задачи
 projectTaskName True string

Имя задачи.
Код проекта
 projectId True integer

Идентификатор проекта.

Возвращаемое значение

Тело
ProjectTask

Поиск клиента по имени

Идентификатор операции:
FindClient

Возвращает клиенты, соответствующие указанному имени.

Параметры

Имя Ключ Обязательно Тип Описание
имя клиента;
 clientName True string

Имя клиента с точным или частичным совпадением.

Возвращаемое значение

response
array of Client

Поиск проекта по имени

Идентификатор операции:
FindProject

Найдите проект по имени.

Параметры

Имя Ключ Обязательно Тип Описание
Имя проекта
 projectName True string

Имя проекта.

Возвращаемое значение

Тело
Project

Поиск тега по имени

Идентификатор операции:
FindTag

Найдите тег по его имени.

Параметры

Имя Ключ Обязательно Тип Описание
Имя тега
 tagName True string

Имя тега.

Возвращаемое значение

Тело
Tag

Получение журналов времени

Идентификатор операции:
GetTimeLogs

Получение подробных журналов действий или журналов времени для диапазона дат.

Параметры

Имя Ключ Обязательно Тип Описание
Дата из
 dateFrom True date

Дата начала в формате YYY-MM-DD.
Дата до
 dateTo True date

Дата окончания в формате YYY-MM-DD.

Возвращаемое значение

Тело
ActivityReportResponse

Создание журнала времени

Идентификатор операции:
CreateLog

Создайте журнал времени. Поле "длительность" или поля "время начала" и "время окончания" должны быть заполнены. В случае всех трех заполнений вы получите ошибку

Параметры

Имя Ключ Обязательно Тип Описание
Date
 date True date

Дата в формате YYY-MM-DD.
Время запуска
 start date-time

Время начала в формате UTC или локальном формате ISO 8601.
Время окончания
 end date-time

Время окончания в формате UTC или локальном формате ISO 8601.
Продолжительность
 duration integer

Длительность в секундах.
Description
 Note string

Заметка.
Код проекта
 ProjectId integer

Идентификатор проекта.
Идентификатор задачи
 TaskId integer

Идентификатор задачи.
Идентификатор тега
 TagId integer

Идентификатор тега.

Возвращаемое значение

Тело
TimeLog

Создание клиента

Идентификатор операции:
CreateClient

Создайте новую запись клиента.

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 Name True string

Имя клиента.

Возвращаемое значение

Тело
Client

Создать проект

Идентификатор операции:
CreateProject

Создание проекта

Параметры

Имя Ключ Обязательно Тип Описание
Имя
 name True string

Имя проекта.
Идентификатор клиента
 clientId integer

Код клиента.
Примечания.
 notes string

Примечания.
Назначенный пользователь
 autoAssignUserId integer

Пользователь, назначенный проекту.

Возвращаемое значение

Тело
Project

Создать тег

Идентификатор операции:
CreateTag

Создайте новый тег.

Параметры

Имя Ключ Обязательно Тип Описание
Имя тега
 name True string

Имя тега.
Шестнадцатеричный цвет
 hexColor True string

Шестнадцатеричный цвет в

Возвращаемое значение

Тело
Tag

Триггеры

При создании нового журнала времени

Активируйте при создании нового журнала времени.
При создании нового проекта

Активируйте при создании нового проекта.
При создании новой задачи

Активируйте при создании новой задачи проекта.

При создании нового журнала времени

Идентификатор операции:
NewTimeLog

Активируйте при создании нового журнала времени.

Возвращаемое значение

Тело
TriggerLogsEnvelope

При создании нового проекта

Идентификатор операции:
NewProject

Активируйте при создании нового проекта.

Возвращаемое значение

Тело
TriggerProjectsEnvelope

При создании новой задачи

Идентификатор операции:
NewTask

Активируйте при создании новой задачи проекта.

Возвращаемое значение

Тело
TriggerProjectTasksEnvelope

Определения

TimeSlice

Имя Путь Тип Описание
id
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
бег
 running boolean
удалено
 deleted boolean

Вложение

Имя Путь Тип Описание
fileName
 fileName string
fileUrl
 fileUrl string
id
 id integer

Тег

Имя Путь Тип Описание
имя
 name string
hexColor
 hexColor string
Архив
 archived boolean
dateArchived
 dateArchived string
id
 id integer

Клиент

Имя Путь Тип Описание
имя
 name string
contactName
 contactName string
контактЭлектронная почта
 contactEmail string
контактТелефон
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
id
 id integer

Проект

Имя Путь Тип Описание
invoiceMethod
 invoiceMethod integer
скорость
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
заметки
 notes string
одобренный
 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
Оплачиваемых
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
имя
 name string
Архив
 archived boolean
customId
 customId string
id
 id integer

ProjectTask

Имя Путь Тип Описание
имя
 name string
orderNo
 orderNo integer
описание
 description string
завершено
 completed boolean
Архив
 archived boolean
startDate
 startDate string
dueDate
 dueDate string
скорость
 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

Имя Путь Тип Описание
заметка
 note string
date
 date string
duration
 duration integer
userName
 userName string
имя проекта
 projectName string
имя задачи
 taskName string
clientName
 clientName string
бег
 running boolean
startTime
 startTime string
endTime
 endTime string
раз
 times array of TimeSlice
статус
 status integer
projectId
 projectId integer
taskId
 taskId integer
Оплачиваемых
 billable boolean
расход
 expense float
userId
 userId integer
billableRate
 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

Имя Путь Тип Описание
logId
 logId integer
userId
 userId integer
date
 date string
TeamsNames
 teamsNames string
userName
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
имя проекта
 projectName string
projectCustomId
 projectCustomId string
projectStartDate
 projectStartDate string
projectDueDate
 projectDueDate string
projectBudgetType
 projectBudgetType string
projectBudgetTarget
 projectBudgetTarget string
projectBudgetPeriodType
 projectBudgetPeriodType string
projectValue
 projectBudgetValue integer
taskListName
 taskListName string
taskId
 taskId integer
имя задачи
 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
скорость
 rate float
Оплачиваемых
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
количество
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
расход
 expense float
billableExpense
 billableExpense float
стоимость
 cost float
заметка
 note string
статус
 status string
идентификатор счета
 invoiceId integer
Выставлен счет
 invoiced boolean
billableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
равновесие
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
teams
 teams array of string
бег
 running boolean
startTime
 startTime string
endTime
 endTime string
раз
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
roundType
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

ActivityReportResponse

Имя Путь Тип Описание
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Имя Путь Тип Описание
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Имя Путь Тип Описание
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
имя
 projects.name string
customId
 projects.customId string
id
 projects.id integer

TriggerProjectTasksEnvelope

Имя Путь Тип Описание
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
имя
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
описание
 projectTasks.description string
скорость
 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