Sdílet prostřednictvím

Moje hodiny (Preview)

Pomocí dynamických výběrů můžete sledovat čas a spravovat projekty, úkoly, klienty a značky. Tento konektor zveřejňuje koncové body pro vytváření a hledání entit.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Moje hodiny
URL https://myhours.com
Email support@myhours.com
Metadata konektoru
Vydavatel Spica International
Internetová stránka https://myhours.com
Zásady ochrany osobních údajů https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Kategorie Produktivita

Moje hodiny – úvod ke konektoru

Pomocí konektoru Moje hodiny můžete sledovat čas a spravovat projekty, úkoly, klienty a značky.

Autentizace

Typ: Klíč rozhraní API (hlavička)

Při vytváření připojení zadejte úplnou hodnotu do jednoho pole s názvem Autorizace pomocí tohoto přesného formátu:

Příklad: apikey 123abcXYZ

Konektor tuto hodnotu odešle jako hlavičku Authorization každého požadavku.

Kde získat klíč: V nastavení účtu Moje hodiny. Vytvořte nebo zkopírujte klíč rozhraní API. Uchovávejte ho v tajnosti a obměňujte ho, pokud je vystavený.

Podporované akce

  • Vytvořit klienta – vytvořte nového klienta.
  • Najít klienta podle názvu – Vrátí klienty, kteří odpovídají zadanému názvu.
  • Vytvořit projekt – vytvořte nový projekt.
  • Najít projekt podle názvu – Najděte projekt podle názvu.
  • Přidat úkol do projektu – vytvoří úkol ve vybraném projektu.
  • Najít úkol podle názvu – Najděte úkol projektu podle názvu a ID projektu.
  • Vytvořit značku – vytvořte novou značku (s šestnáctkovou barvou).
  • Najít značku podle názvu – Najděte značku podle názvu.
  • Vytvořit časový protokol – vytvoří nový časový protokol.
  • Získání časových protokolů – Načtení podrobných protokolů aktivit a času pro rozsah kalendářních dat

Podporované triggery

  • Když se vytvoří nový projekt – aktivuje se při zobrazení nového projektu.
  • Při vytvoření nového úkolu se aktivuje při zobrazení nového úkolu projektu.
  • Při vytvoření nového časového protokolu se aktivuje , když se zobrazí nový časový protokol.

Poznámky k využití a limity

  • Formát autorizace – Připojení vyžaduje předponu apikey literálu následovanou vaším klíčem. Pokud předponu vynecháte nebo přidáte nadbytečné znaky, požadavky můžou selhat s 400 nebo 401.
  • Formáty data a času – Data jsou YYYY-MM-DD. Hodnoty data a času jsou ISO 8601 (např. 2025-09-05T08:30:00Z místní posun).
  • Vytváření časových protokolů – Zadejte (duration sekundy) nebo obojí start i end. Zadání všech tří je neplatné.
  • Dynamické výběry – pole Projekt, Úkol, Značka a Uživatel používají dynamické seznamy; ujistěte se, že váš účet má oprávnění ke čtení těchto entit nebo můžou být seznamy prázdné.
  • Prostředí – Podporuje se pouze hostitel produkčního rozhraní API: https://api2.myhours.com.

Zpracování chyb

Konektor vrátí standardní stavové kódy HTTP:

Code Meaning Typické příčiny
200 Success Operace čtení a seznamu
201 Vytvořené Úspěšné operace vytvoření
400 Chybný požadavek Chybějící nebo neplatné vstupy, nesprávný formát záhlaví, konfliktní textová pole.
500 Chyba serveru Dočasný problém s back-endem nebo neočekávaná chyba

Troubleshooting

  1. Ověřte, že hodnota autorizace používá přesný apikey YOUR_API_KEY formát.
  2. Zkontrolujte, jestli jsou požadovaná pole k dispozici a jsou platná.
  3. V případě vytvoření časového protokolu potvrďte, že jste prošli buďdurationnebo (start a end).

Záznam změn

  • 1.0.0 – Počáteční odeslání k certifikaci.

Support

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Authorization securestring Autorizace pro toto rozhraní API Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Najít klienta podle názvu

Vrátí klienty, kteří odpovídají zadanému názvu.
Najít projekt podle názvu

Vyhledejte projekt podle názvu.
Najít značku podle názvu

Najděte značku podle názvu.
Najít úkol podle názvu

Vyhledejte úkol projektu podle názvu a ID projektu.
Přidat úkol do projektu

Vytvořte úkol ve vybraném projektu.
Vytvoření klienta

Vytvořte nový záznam klienta.
Vytvoření časového protokolu

Vytvořte časový protokol. Je třeba vyplnit pole "doba trvání" nebo pole "počáteční čas" a "koncový čas". V případě vyplnění všech tří se zobrazí chyba.
Vytvořit projekt

Vytvořte nový projekt.
Vytvořit značku

Vytvořte novou značku.
Získání časových protokolů

Získejte podrobné protokoly aktivit nebo času pro rozsah kalendářních dat.

Najít klienta podle názvu

ID operace:
FindClient

Vrátí klienty, kteří odpovídají zadanému názvu.

Parametry

Name Klíč Vyžadováno Typ Description
Název klienta
 clientName True string

Název klienta s přesnou nebo částečnou shodu

Návraty

response
array of Client

Najít projekt podle názvu

ID operace:
FindProject

Vyhledejte projekt podle názvu.

Parametry

Name Klíč Vyžadováno Typ Description
Název projektu
 projectName True string

Název projektu.

Návraty

Body
Project

Najít značku podle názvu

ID operace:
FindTag

Najděte značku podle názvu.

Parametry

Name Klíč Vyžadováno Typ Description
Název značky
 tagName True string

Název značky

Návraty

Body
Tag

Najít úkol podle názvu

ID operace:
FindTask

Vyhledejte úkol projektu podle názvu a ID projektu.

Parametry

Name Klíč Vyžadováno Typ Description
Název úkolu
 projectTaskName True string

Název úkolu
ID projektu
 projectId True integer

ID projektu.

Návraty

Body
ProjectTask

Přidat úkol do projektu

ID operace:
CreateProjectTask

Vytvořte úkol ve vybraném projektu.

Parametry

Name Klíč Vyžadováno Typ Description
ID projektu
 projectId True integer

ID projektu.
Název seznamu:
 listName string

Název seznamu úkolů
Název
 name True string

Název úkolu
Description
 description string

Description.

Návraty

Body
ProjectTask

Vytvoření klienta

ID operace:
CreateClient

Vytvořte nový záznam klienta.

Parametry

Name Klíč Vyžadováno Typ Description
Název
 Name True string

Název klienta.

Návraty

Body
Client

Vytvoření časového protokolu

ID operace:
CreateLog

Vytvořte časový protokol. Je třeba vyplnit pole "doba trvání" nebo pole "počáteční čas" a "koncový čas". V případě vyplnění všech tří se zobrazí chyba.

Parametry

Name Klíč Vyžadováno Typ Description
Date
 date True date

Datum ve formátu RRRR-MM-DD.
Čas zahájení
 start date-time

Počáteční čas ve formátu UTC nebo v místním formátu ISO 8601.
Konečný čas
 end date-time

Koncový čas ve formátu UTC nebo v místním formátu ISO 8601.
Doba trvání
 duration integer

Doba trvání v sekundách.
Description
 Note string

Poznámka.
ID projektu
 ProjectId integer

ID projektu.
ID úkolu
 TaskId integer

ID úkolu.
ID značky
 TagId integer

ID značky.

Návraty

Body
TimeLog

Vytvořit projekt

ID operace:
CreateProject

Vytvořte nový projekt.

Parametry

Name Klíč Vyžadováno Typ Description
Název
 name True string

Název projektu.
ID klienta
 clientId integer

ID klienta.
Poznámky
 notes string

Poznámky.
Přiřazený uživatel
 autoAssignUserId integer

Uživatel přiřazený k projektu.

Návraty

Body
Project

Vytvořit značku

ID operace:
CreateTag

Vytvořte novou značku.

Parametry

Name Klíč Vyžadováno Typ Description
Název značky
 name True string

Název značky
Šestnáctkové barvy
 hexColor True string

Šestnáctkové barvy v

Návraty

Body
Tag

Získání časových protokolů

ID operace:
GetTimeLogs

Získejte podrobné protokoly aktivit nebo času pro rozsah kalendářních dat.

Parametry

Name Klíč Vyžadováno Typ Description
Datum od:
 dateFrom True date

Počáteční datum ve formátu RRRR-MM-DD.
Datum do
 dateTo True date

Koncové datum ve formátu RRRR-MM-DD.

Návraty

Body
ActivityReportResponse

Aktivační události

Při vytvoření nového projektu

Aktivace při vytvoření nového projektu
Při vytvoření nového úkolu

Aktivuje se při vytvoření nového úkolu projektu.
Při vytvoření nového časového protokolu

Aktivuje se při vytvoření nového časového protokolu.

Při vytvoření nového projektu

ID operace:
NewProject

Aktivace při vytvoření nového projektu

Návraty

Body
TriggerProjectsEnvelope

Při vytvoření nového úkolu

ID operace:
NewTask

Aktivuje se při vytvoření nového úkolu projektu.

Návraty

Body
TriggerProjectTasksEnvelope

Při vytvoření nového časového protokolu

ID operace:
NewTimeLog

Aktivuje se při vytvoření nového časového protokolu.

Návraty

Body
TriggerLogsEnvelope

Definice

TimeSlice

Name Cesta Typ Description
identifikační číslo
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
běží
 running boolean
smazaný
 deleted boolean

Attachment

Name Cesta Typ Description
fileName
 fileName string
fileUrl
 fileUrl string
identifikační číslo
 id integer

Štítek

Name Cesta Typ Description
název
 name string
hexColor
 hexColor string
archivovaný
 archived boolean
dateArchived
 dateArchived string
identifikační číslo
 id integer

Klient

Name Cesta Typ Description
název
 name string
contactName
 contactName string
kontaktEmail
 contactEmail string
contactPhone
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
identifikační číslo
 id integer

Projekt

Name Cesta Typ Description
invoiceMethod
 invoiceMethod integer
sazba
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
poznámky
 notes string
schválený
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
splatné datum
 dueDate string
dateCreated
 dateCreated string
createdByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
zúčtovatelný
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
název
 name string
archivovaný
 archived boolean
customId
 customId string
identifikační číslo
 id integer

ProjectTask

Name Cesta Typ Description
název
 name string
orderNo
 orderNo integer
popis
 description string
dokončené
 completed boolean
archivovaný
 archived boolean
startDate
 startDate string
splatné datum
 dueDate string
sazba
 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
identifikační číslo
 id integer

Časový protokol

Name Cesta Typ Description
poznámka
 note string
date
 date string
duration
 duration integer
userName
 userName string
název projektu
 projectName string
taskName
 taskName string
clientName
 clientName string
běží
 running boolean
startTime
 startTime string
endTime
 endTime string
krát
 times array of TimeSlice
stav
 status integer
ID projektu
 projectId integer
taskId
 taskId integer
zúčtovatelný
 billable boolean
výdaj
 expense float
userId
 userId integer
fakturovatelná rychlost
 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
identifikační číslo
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name Cesta Typ Description
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
ID projektu
 projectId integer
název projektu
 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
sazba
 rate float
zúčtovatelný
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
množství
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
výdaj
 expense float
billableExpense
 billableExpense float
náklady
 cost float
poznámka
 note string
stav
 status string
id faktury
 invoiceId integer
fakturovaný
 invoiced boolean
fakturovatelného hours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
zůstatek
 balance integer
monthOfYear
 monthOfYear string
WeekNo
 weekNo integer
weekOfYear
 weekOfYear string
týmy
 teams array of string
běží
 running boolean
startTime
 startTime string
endTime
 endTime string
krát
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
roundType
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

ActivityReportResponse

Name Cesta Typ Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name Cesta Typ Description
protokoly
 logs array of TimeLog

TriggerProjectsEnvelope

Name Cesta Typ Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
název
 projects.name string
customId
 projects.customId string
identifikační číslo
 projects.id integer

TriggerProjectTasksEnvelope

Name Cesta Typ Description
projectTasks
 projectTasks array of object
ID projektu
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
název
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
popis
 projectTasks.description string
sazba
 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
identifikační číslo
 projectTasks.id integer