Delen via

Mijn uren (preview)

Houd tijd bij en beheer projecten, taken, clients en tags met dynamische kiezers. Deze connector maakt eindpunten beschikbaar voor het maken en vinden van entiteiten.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Mijn uren
URL https://myhours.com
E-mailen support@myhours.com
Connectormetagegevens
Uitgever Spica International
Webpagina https://myhours.com
Privacybeleid https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Categorieën Productiviteit

My Hours - Inleiding tot connector

Houd tijd bij en beheer projecten, taken, clients en tags met behulp van de connector Mijn uren.

Authenticatie

Type: API-sleutel (header)

Wanneer u een verbinding maakt, voert u de volledige waarde in het veld Autorisatie in met behulp van deze exacte indeling:

Voorbeeld: apikey 123abcXYZ

De connector verzendt deze waarde als header Authorization voor elke aanvraag.

Waar kunt u de sleutel ophalen: Vanuit de accountinstellingen Mijn uren. Een API-sleutel maken of kopiëren. Bewaar het geheim en draai het indien beschikbaar.

Ondersteunde acties

  • Client maken : een nieuwe client maken.
  • Zoek client op naam : retourneert clients die overeenkomen met de opgegeven naam.
  • Project maken : een nieuw project maken.
  • Project zoeken op naam : zoek een project op naam.
  • Taak toevoegen aan Project : een taak maken voor een geselecteerd project.
  • Taak zoeken op naam: zoek een projecttaak op naam en project-id.
  • Tag maken : een nieuwe tag maken (met hexkleur).
  • Tag zoeken op naam : zoek een tag op naam.
  • Tijdlogboek maken : een nieuw tijdlogboek maken.
  • Tijdlogboeken ophalen : gedetailleerde activiteiten-/tijdlogboeken ophalen voor een datumbereik.

Ondersteunde triggers

  • Wanneer een nieuw project wordt gemaakt : wordt geactiveerd wanneer een nieuw project wordt weergegeven.
  • Wanneer een nieuwe taak wordt gemaakt : wordt geactiveerd wanneer een nieuwe projecttaak wordt weergegeven.
  • Wanneer er een nieuw tijdlogboek wordt gemaakt : wordt geactiveerd wanneer er een nieuw tijdlogboek wordt weergegeven.

Gebruiksnotities en limieten

  • Autorisatie-indeling : voor de verbinding is het letterlijke voorvoegsel apikey vereist, gevolgd door uw sleutel. Als u het voorvoegsel weglaat of extra tekens toevoegt, kunnen aanvragen mislukken met 400 of 401.
  • Datum-/tijdnotaties: datums zijn JJJJ-MM-DD. Datum-/tijdwaarden zijn ISO 8601 (bijvoorbeeld 2025-09-05T08:30:00Z een lokale offset).
  • Tijdlogboeken maken: geefduration (seconden) of beide start en endop. Het leveren van alle drie is ongeldig.
  • Dynamische kiezers : velden Project, Taak, Tag en Gebruiker maken gebruik van dynamische lijsten; zorg ervoor dat uw account gemachtigd is om deze entiteiten te lezen of dat de lijsten leeg zijn.
  • Omgeving : alleen de productie-API-host wordt ondersteund: https://api2.myhours.com.

Foutafhandeling

De connector retourneert standaard HTTP-statuscodes:

Code Meaning Typische oorzaken
200 Success Lees-/lijstbewerkingen.
201 Gecreëerd Geslaagde bewerkingen voor maken.
400 Foutieve aanvraag Ontbrekende/ongeldige invoer, verkeerde koptekstindeling, conflicterende hoofdtekstvelden.
500 Serverfout Tijdelijk back-endprobleem of onverwachte fout.

Troubleshooting

  1. Controleer of de autorisatiewaarde de exacte apikey YOUR_API_KEY indeling gebruikt.
  2. Controleer of de vereiste velden aanwezig en geldig zijn.
  3. Voor tijdlogboek maken bevestigt u dat uhebt doorgegeven durationof (start en end).

Wijzigingslogboek

  • 1.0.0 – Eerste indiening voor certificering.

Support

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Authorization beveiligde string De autorisatie voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Client maken

Maak een nieuwe clientrecord.
Client zoeken op naam

Clients retourneren die overeenkomen met de opgegeven naam.
Project maken

Maak een nieuw project.
Project zoeken op naam

Zoek een project op naam.
Taak toevoegen aan Project

Een taak maken voor een geselecteerd project.
Taak zoeken op naam

Zoek een projecttaak op naam en project-id.
Tag maken

Maak een nieuwe tag.
Tag zoeken op naam

Zoek een tag op naam.
Tijdlogboek maken

Maak een tijdlogboek. Het veld 'duur' of de velden 'begintijd' en 'eindtijd' moeten worden ingevuld. In het geval dat alle drie worden ingevuld, krijgt u een foutmelding
Tijdlogboeken ophalen

Gedetailleerde activiteiten- of tijdlogboeken ophalen voor een datumbereik.

Client maken

Bewerkings-id:
CreateClient

Maak een nieuwe clientrecord.

Parameters

Name Sleutel Vereist Type Description
Naam
 Name True string

Clientnaam.

Retouren

Body
Client

Client zoeken op naam

Bewerkings-id:
FindClient

Clients retourneren die overeenkomen met de opgegeven naam.

Parameters

Name Sleutel Vereist Type Description
Clientnaam
 clientName True string

Clientnaam met exacte of gedeeltelijke overeenkomst.

Retouren

response
array of Client

Project maken

Bewerkings-id:
CreateProject

Maak een nieuw project.

Parameters

Name Sleutel Vereist Type Description
Naam
 name True string

Projectnaam.
Klant-ID
 clientId integer

Client-id.
Opmerkingen
 notes string

Notities.
Toegewezen gebruiker
 autoAssignUserId integer

Gebruiker die is toegewezen aan het project.

Retouren

Body
Project

Project zoeken op naam

Bewerkings-id:
FindProject

Zoek een project op naam.

Parameters

Name Sleutel Vereist Type Description
Projectnaam
 projectName True string

Projectnaam.

Retouren

Body
Project

Taak toevoegen aan Project

Bewerkings-id:
CreateProjectTask

Een taak maken voor een geselecteerd project.

Parameters

Name Sleutel Vereist Type Description
Project-id
 projectId True integer

Project-id.
Lijstnaam
 listName string

Naam van takenlijst.
Naam
 name True string

Taaknaam.
Description
 description string

Description.

Retouren

Body
ProjectTask

Taak zoeken op naam

Bewerkings-id:
FindTask

Zoek een projecttaak op naam en project-id.

Parameters

Name Sleutel Vereist Type Description
Taaknaam
 projectTaskName True string

Taaknaam.
Project-id
 projectId True integer

Project-id.

Retouren

Body
ProjectTask

Tag maken

Bewerkings-id:
CreateTag

Maak een nieuwe tag.

Parameters

Name Sleutel Vereist Type Description
Naam van tag
 name True string

Tagnaam.
Hexkleur
 hexColor True string

Hexkleur in

Retouren

Body
Tag

Tag zoeken op naam

Bewerkings-id:
FindTag

Zoek een tag op naam.

Parameters

Name Sleutel Vereist Type Description
Naam van tag
 tagName True string

Tagnaam.

Retouren

Body
Tag

Tijdlogboek maken

Bewerkings-id:
CreateLog

Maak een tijdlogboek. Het veld 'duur' of de velden 'begintijd' en 'eindtijd' moeten worden ingevuld. In het geval dat alle drie worden ingevuld, krijgt u een foutmelding

Parameters

Name Sleutel Vereist Type Description
Datum
 date True date

Datum in JJJJ-MM-DD notatie.
Begintijd
 start date-time

Begintijd in UTC- of lokale ISO 8601-indeling.
Eindtijd
 end date-time

Eindtijd in UTC- of lokale ISO 8601-indeling.
Duur
 duration integer

Duur in seconden.
Description
 Note string

Notitie.
Project-id
 ProjectId integer

Project-id.
Taak-id
 TaskId integer

Taak-id.
Tag-id
 TagId integer

Tag-id.

Retouren

Body
TimeLog

Tijdlogboeken ophalen

Bewerkings-id:
GetTimeLogs

Gedetailleerde activiteiten- of tijdlogboeken ophalen voor een datumbereik.

Parameters

Name Sleutel Vereist Type Description
Datum vanaf
 dateFrom True date

Begindatum in JJJJ-MM-DD indeling.
Datum tot
 dateTo True date

Einddatum in JJJJ-MM-DD notatie.

Retouren

Body
ActivityReportResponse

Triggers

Wanneer een nieuw project wordt gemaakt

Trigger wanneer een nieuw project wordt gemaakt.
Wanneer een nieuwe taak wordt gemaakt

Trigger wanneer een nieuwe projecttaak wordt gemaakt.
Wanneer er een nieuw tijdlogboek wordt gemaakt

Trigger wanneer er een nieuw tijdlogboek wordt gemaakt.

Wanneer een nieuw project wordt gemaakt

Bewerkings-id:
NewProject

Trigger wanneer een nieuw project wordt gemaakt.

Retouren

Body
TriggerProjectsEnvelope

Wanneer een nieuwe taak wordt gemaakt

Bewerkings-id:
NewTask

Trigger wanneer een nieuwe projecttaak wordt gemaakt.

Retouren

Body
TriggerProjectTasksEnvelope

Wanneer er een nieuw tijdlogboek wordt gemaakt

Bewerkings-id:
NewTimeLog

Trigger wanneer er een nieuw tijdlogboek wordt gemaakt.

Retouren

Body
TriggerLogsEnvelope

Definities

TimeSlice

Name Pad Type Description
identiteitskaart
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
draaien
 running boolean
verwijderd
 deleted boolean

Attachment

Name Pad Type Description
fileName
 fileName string
fileUrl
 fileUrl string
identiteitskaart
 id integer

Tag

Name Pad Type Description
naam
 name string
hexColor
 hexColor string
Gearchiveerde
 archived boolean
dateArchived
 dateArchived string
identiteitskaart
 id integer

Client

Name Pad Type Description
naam
 name string
contactNaam
 contactName string
contactE-mail
 contactEmail string
contactTelefoon
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
identiteitskaart
 id integer

Project

Name Pad Type Description
invoiceMethod
 invoiceMethod integer
verhouding
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
Notities
 notes string
Goedgekeurd
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
vervaldatum
 dueDate string
dateCreated
 dateCreated string
gemaaktDoorUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
Factureerbare
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
naam
 name string
Gearchiveerde
 archived boolean
customId
 customId string
identiteitskaart
 id integer

ProjectTask

Name Pad Type Description
naam
 name string
orderNo
 orderNo integer
beschrijving
 description string
voltooid
 completed boolean
Gearchiveerde
 archived boolean
startDate
 startDate string
vervaldatum
 dueDate string
verhouding
 rate float
factableByDefault
 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
identiteitskaart
 id integer

TimeLog

Name Pad Type Description
notitie
 note string
date
 date string
duration
 duration integer
gebruikersnaam
 userName string
projectNaam
 projectName string
taskName
 taskName string
clientName
 clientName string
draaien
 running boolean
startTime
 startTime string
endTime
 endTime string
keer
 times array of TimeSlice
status
 status integer
projectId
 projectId integer
taskId
 taskId integer
Factureerbare
 billable boolean
kosten
 expense float
userId
 userId integer
billableRate
 billableRate float
factureerbareAmount
 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
identiteitskaart
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name Pad Type Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
gebruikersnaam
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
projectNaam
 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
verhouding
 rate float
Factureerbare
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
factureerbareAmount
 billableAmount float
aantal
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
kosten
 expense float
factureerbareExpense
 billableExpense float
kosten
 cost float
notitie
 note string
status
 status string
FactuurId
 invoiceId integer
Gefactureerd
 invoiced boolean
factureerbare uren
 billableHours integer
factureerbareHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
evenwicht
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
Teams
 teams array of string
draaien
 running boolean
startTime
 startTime string
endTime
 endTime string
keer
 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 Pad Type Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name Pad Type Description
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Name Pad Type Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
naam
 projects.name string
customId
 projects.customId string
identiteitskaart
 projects.id integer

TriggerProjectTasksEnvelope

Name Pad Type Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
naam
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
beschrijving
 projectTasks.description string
verhouding
 projectTasks.rate float
budgetValue
 projectTasks.budgetValue float
projectBudgetType
 projectTasks.projectBudgetType integer
customId
 projectTasks.customId string
factableByDefault
 projectTasks.billableByDefault boolean
projectCustomId
 projectTasks.projectCustomId string
clientCustomId
 projectTasks.clientCustomId string
identiteitskaart
 projectTasks.id integer