다음을 통해 공유

내 시간(미리 보기)

시간을 추적하고 동적 선택기를 사용하여 프로젝트, 작업, 클라이언트 및 태그를 관리합니다. 이 커넥터는 엔터티를 만들고 찾기 위한 엔드포인트를 노출합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 내 시간
URL https://myhours.com
전자 메일 support@myhours.com
커넥터 메타데이터
게시자 스피카 인터내셔널
웹 사이트 https://myhours.com
개인 정보 보호 정책 https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
카테고리 생산력

내 시간 - 커넥터 소개

My Hours 커넥터를 사용하여 시간을 추적하고 프로젝트, 작업, 클라이언트 및 태그를 관리합니다.

Authentication

형: API 키(헤더)

연결을 만들 때 이 정확한 형식을 사용하여 Authorization이라는 단일 필드에 전체 값을 입력합니다.

예: apikey 123abcXYZ

커넥터는 이 값을 모든 요청의 Authorization 헤더로 보냅니다.

키를 가져올 위치: 내 시간 계정 설정에서. API 키를 만들거나 복사합니다. 비밀을 유지하고 노출된 경우 회전합니다.

지원되는 작업

  • 클라이언트 만들기 – 새 클라이언트를 만듭니다.
  • 이름별 클라이언트 찾기 – 제공된 이름과 일치하는 클라이언트를 반환합니다.
  • 프로젝트 만들기 – 새 프로젝트를 만듭니다.
  • 이름으로 프로젝트 찾기 - 이름으로 프로젝트를 찾습니다.
  • 프로젝트에 작업 추가 – 선택한 프로젝트에 작업을 만듭니다.
  • 이름으로 작업 찾기 – 이름 및 프로젝트 ID별로 프로젝트 작업을 찾습니다.
  • 태그 만들기 – 16진수 색으로 새 태그를 만듭니다.
  • 이름별 태그 찾기 - 이름으로 태그를 찾습니다.
  • 시간 로그 만들기 – 새 시간 로그를 만듭니다.
  • 시간 로그 가져오기 – 날짜 범위에 대한 자세한 활동/시간 로그를 검색합니다.

지원되는 트리거

  • 새 프로젝트를 만들 때 – 새 프로젝트가 나타나면 발생합니다.
  • 새 작업이 만들어지면 - 새 프로젝트 작업이 나타날 때 발생합니다.
  • 새 시간 로그를 만들 때 – 새 시간 로그가 나타나면 발생합니다.

사용 현황 정보 및 제한

  • 권한 부여 형식 – 연결에는 리터럴 접두 apikey 사 뒤에 키가 필요합니다. 접두사를 생략하거나 추가 문자를 추가하면 요청이 400 또는 401로 실패할 수 있습니다.
  • 날짜/시간 형식 – 날짜는 YYYY-MM-DD입니다. 날짜/시간 값은 ISO 8601(예: 2025-09-05T08:30:00Z 로컬 오프셋)입니다.
  • 시간 로그 만들기 – (초) 또는 둘 durationstart 제공 및 end. 세 가지를 모두 제공하는 것은 유효하지 않습니다.
  • 동적 선택기 – 프로젝트, 작업, 태그 및 사용자 필드는 동적 목록을 사용합니다. 계정에 해당 엔터티를 읽을 수 있는 권한이 있거나 목록이 비어 있는지 확인합니다.
  • 환경 – 프로덕션 API 호스트만 지원 https://api2.myhours.com됩니다.

오류 처리

커넥터는 표준 HTTP 상태 코드를 반환합니다.

코드 Meaning 일반적인 원인
200 성공 읽기/나열 작업입니다.
201 생성됨 성공적인 만들기 작업.
400 잘못된 요청 누락/잘못된 입력, 잘못된 헤더 형식, 충돌하는 본문 필드.
500 서버 오류 임시 백 엔드 문제 또는 예기치 않은 오류입니다.

Troubleshooting

  1. 권한 부여 값이 정확한 apikey YOUR_API_KEY 형식을 사용하는지 확인합니다.
  2. 필수 필드가 있고 유효한지 확인합니다.
  3. 시간 로그 만들기의 경우 전달 여부를duration 확인합니다startend.

변경사항 기록

  • 1.0.0 – 인증을 위한 초기 제출입니다.

Support

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
Authorization 시큐어스트링 (보안 문자열) 이 API에 대한 권한 부여 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

시간 로그 가져오기

날짜 범위에 대한 자세한 활동 또는 시간 로그를 가져옵니다.
시간 로그 만들기

시간 로그를 만듭니다. 필드 'duration' 또는 필드 '시작 시간' 및 '종료 시간'을 입력해야 합니다. 세 가지가 모두 채워지는 경우 오류가 발생합니다.
이름으로 작업 찾기

이름 및 프로젝트 ID별로 프로젝트 작업을 찾습니다.
이름으로 클라이언트 찾기

제공된 이름과 일치하는 클라이언트를 반환합니다.
이름으로 태그 찾기

이름으로 태그를 찾습니다.
이름으로 프로젝트 찾기

이름으로 프로젝트를 찾습니다.
클라이언트 만들기

새 클라이언트 레코드를 만듭니다.
태그 생성

새 태그를 만듭니다.
프로젝트 생성

새 프로젝트를 만듭니다.
프로젝트에 작업 추가

선택한 프로젝트에 작업을 만듭니다.

시간 로그 가져오기

작업 ID:
GetTimeLogs

날짜 범위에 대한 자세한 활동 또는 시간 로그를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
날짜:
 dateFrom True date

YYYY-MM-DD 형식의 시작 날짜입니다.
날짜-날짜
 dateTo True date

종료 날짜(YYYY-MM-DD 형식)

반환

몸
ActivityReportResponse

시간 로그 만들기

작업 ID:
CreateLog

시간 로그를 만듭니다. 필드 'duration' 또는 필드 '시작 시간' 및 '종료 시간'을 입력해야 합니다. 세 가지가 모두 채워지는 경우 오류가 발생합니다.

매개 변수

Name 키 필수 형식 Description
날짜
 date True date

YYYY-MM-DD 형식의 날짜입니다.
시작 시간
 start date-time

시작 시간은 UTC 또는 로컬 ISO 8601 형식입니다.
종료 시간
 end date-time

종료 시간(UTC 또는 로컬 ISO 8601 형식)입니다.
기간
 duration integer

기간(초)입니다.
Description
 Note string

메모.
프로젝트 ID
 ProjectId integer

프로젝트 ID입니다.
작업 ID
 TaskId integer

작업 ID입니다.
태그 ID
 TagId integer

태그 ID입니다.

반환

몸
TimeLog

이름으로 작업 찾기

작업 ID:
FindTask

이름 및 프로젝트 ID별로 프로젝트 작업을 찾습니다.

매개 변수

Name 키 필수 형식 Description
작업 이름
 projectTaskName True string

작업 이름입니다.
프로젝트 ID
 projectId True integer

프로젝트 ID입니다.

반환

몸
ProjectTask

이름으로 클라이언트 찾기

작업 ID:
FindClient

제공된 이름과 일치하는 클라이언트를 반환합니다.

매개 변수

Name 키 필수 형식 Description
클라이언트 이름
 clientName True string

정확히 일치하거나 부분적으로 일치하는 클라이언트 이름입니다.

반환

response
array of Client

이름으로 태그 찾기

작업 ID:
FindTag

이름으로 태그를 찾습니다.

매개 변수

Name 키 필수 형식 Description
태그 이름
 tagName True string

태그 이름입니다.

반환

몸
Tag

이름으로 프로젝트 찾기

작업 ID:
FindProject

이름으로 프로젝트를 찾습니다.

매개 변수

Name 키 필수 형식 Description
프로젝트 이름
 projectName True string

프로젝트 이름입니다.

반환

몸
Project

클라이언트 만들기

작업 ID:
CreateClient

새 클라이언트 레코드를 만듭니다.

매개 변수

Name 키 필수 형식 Description
이름
 Name True string

클라이언트 이름입니다.

반환

몸
Client

태그 생성

작업 ID:
CreateTag

새 태그를 만듭니다.

매개 변수

Name 키 필수 형식 Description
태그 이름
 name True string

태그 이름입니다.
16진수 색
 hexColor True string

16진수 색

반환

몸
Tag

프로젝트 생성

작업 ID:
CreateProject

새 프로젝트를 만듭니다.

매개 변수

Name 키 필수 형식 Description
이름
 name True string

프로젝트 이름입니다.
클라이언트 ID
 clientId integer

클라이언트 ID.
비고
 notes string

노트.
할당된 사용자
 autoAssignUserId integer

프로젝트에 할당된 사용자입니다.

반환

몸
Project

프로젝트에 작업 추가

작업 ID:
CreateProjectTask

선택한 프로젝트에 작업을 만듭니다.

매개 변수

Name 키 필수 형식 Description
프로젝트 ID
 projectId True integer

프로젝트 ID입니다.
목록 이름
 listName string

작업 목록 이름입니다.
이름
 name True string

작업 이름입니다.
Description
 description string

Description.

반환

몸
ProjectTask

트리거

새 시간 로그가 만들어지는 경우

새 시간 로그를 만들 때 트리거합니다.
새 작업이 만들어지는 경우

새 프로젝트 작업을 만들 때 트리거합니다.
새 프로젝트를 만드는 경우

새 프로젝트를 만들 때 트리거합니다.

새 시간 로그가 만들어지는 경우

작업 ID:
NewTimeLog

새 시간 로그를 만들 때 트리거합니다.

반환

몸
TriggerLogsEnvelope

새 작업이 만들어지는 경우

작업 ID:
NewTask

새 프로젝트 작업을 만들 때 트리거합니다.

반환

몸
TriggerProjectTasksEnvelope

새 프로젝트를 만드는 경우

작업 ID:
NewProject

새 프로젝트를 만들 때 트리거합니다.

반환

몸
TriggerProjectsEnvelope

정의

TimeSlice

Name 경로 형식 Description
아이디
 id integer
duration
 duration integer
startTime
 startTime string
endTime 사이에서
 endTime string
실행 중
 running boolean
삭제됨
 deleted boolean

Attachment

Name 경로 형식 Description
fileName
 fileName string
fileUrl
 fileUrl string
아이디
 id integer

Tag

Name 경로 형식 Description
이름
 name string
hexColor
 hexColor string
보관
 archived boolean
dateArchived
 dateArchived string
아이디
 id integer

클라이언트

Name 경로 형식 Description
이름
 name string
연락처 이름
 contactName string
연락처이메일
 contactEmail string
연락처전화
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
아이디
 id integer

프로젝트

Name 경로 형식 Description
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 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 integer

ProjectTask

Name 경로 형식 Description
이름
 name string
orderNo
 orderNo integer
description
 description string
완료됨
 completed boolean
보관
 archived boolean
startDate
 startDate string
기한날짜
 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 integer

TimeLog

Name 경로 형식 Description
메모
 note string
date
 date string
duration
 duration integer
사용자 이름
 userName string
프로젝트 이름
 projectName string
taskName
 taskName string
clientName
 clientName string
실행 중
 running boolean
startTime
 startTime string
endTime 사이에서
 endTime string
배
 times array of TimeSlice
status
 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 integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name 경로 형식 Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
사용자 이름
 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
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
율
 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
 status string
청구서 ID
 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 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

Name 경로 형식 Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name 경로 형식 Description
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Name 경로 형식 Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
이름
 projects.name string
customId
 projects.customId string
아이디
 projects.id integer

TriggerProjectTasksEnvelope

Name 경로 형식 Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
이름
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
description
 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
아이디
 projectTasks.id integer