Aracılığıyla paylaş

Saatlerim (Önizleme)

Dinamik seçicilerle zaman izleyin ve projeleri, görevleri, istemcileri ve etiketleri yönetin. Bu bağlayıcı varlıkları oluşturmak ve bulmak için uç noktaları kullanıma sunar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Saatlerim
URL https://myhours.com
E-posta support@myhours.com
Bağlayıcı Meta Verileri
Publisher Spica International
Web sitesi https://myhours.com
Gizlilik ilkesi https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Kategoriler Verimli -lik

Saatlerim - Bağlayıcıya Giriş

Saatlerim bağlayıcısını kullanarak zamanı izleyin ve projeleri, görevleri, istemcileri ve etiketleri yönetin.

Authentication

Tür: API anahtarı (üst bilgi)

Bağlantı oluştururken, tam olarak şu biçimi kullanarak Yetkilendirme adlı tek alana tam değeri girin:

Örnek: apikey 123abcXYZ

Bağlayıcı bu değeri her istekte Authorization üst bilgi olarak gönderir.

Anahtarı nereden alabilirim: Saatlerim hesap ayarlarınızdan. API anahtarı oluşturma veya kopyalama. Gizli tutun ve gösterildiyse döndürün.

Desteklenen eylemler

  • İstemci Oluştur – Yeni bir istemci oluşturun.
  • Ada Göre İstemciyi Bul – Sağlanan adla eşleşen istemcileri döndürür.
  • Proje Oluşturma – Yeni proje oluşturma.
  • Ada Göre Proje Bul – Projeyi ada göre bulma.
  • Projeye Görev Ekle – Seçili bir projede görev oluşturun.
  • Ada Göre Görev Bul – Ada ve proje kimliğine göre bir proje görevi bulun.
  • Etiket Oluştur – Yeni bir etiket oluşturun (onaltılık renkle).
  • Ada Göre Etiket Bul – Ada göre bir etiket bulun.
  • Zaman Günlüğü Oluşturma – Yeni bir zaman günlüğü oluşturun.
  • Saat Günlüklerini Alma – Bir tarih aralığı için ayrıntılı etkinlik/saat günlüklerini alın.

Desteklenen tetikleyiciler

  • Yeni bir Proje oluşturulduğunda – Yeni bir proje görüntülendiğinde tetikler.
  • Yeni bir Görev oluşturulduğunda – Yeni bir proje görevi görüntülendiğinde tetikler.
  • Yeni bir Zaman Günlüğü oluşturulduğunda – Yeni bir zaman günlüğü görüntülendiğinde tetikler.

Kullanım notları ve sınırları

  • Yetkilendirme biçimi – Bağlantı için sabit ön ek apikey ve ardından anahtarınız gerekir. Ön eki atlar veya ek karakterler eklerseniz, istekler 400 veya 401 ile başarısız olabilir.
  • Tarih/saat biçimleri : Tarihler YYYY-AA-GG'dır. Tarih/saat değerleri ISO 8601'dir (örneğin 2025-09-05T08:30:00Z , yerel uzaklık).
  • Zaman günlükleri oluşturma– (saniye) duration her ikisini de ve startsağlayın end . Üçünü de sağlamak geçersiz.
  • Dinamik seçiciler – Proje, Görev, Etiket ve Kullanıcı alanları dinamik listeleri kullanır; hesabınızın bu varlıkları okuma iznine sahip olduğundan veya listelerin boş olabileceğinden emin olun.
  • Ortam – Yalnızca üretim API'sinin konağı desteklenir: https://api2.myhours.com.

Hata yönetimi

Bağlayıcı standart HTTP durum kodlarını döndürür:

Kod Meaning Tipik nedenler
200 Success Okuma/listeleme işlemleri.
201 Oluşturuldu Başarılı oluşturma işlemleri.
400 Hatalı istek Eksik/geçersiz girişler, yanlış üst bilgi biçimi, çakışan gövde alanları.
500 Sunucu hatası Geçici arka uç sorunu veya beklenmeyen hata.

Troubleshooting

  1. Yetkilendirme değerinin tam apikey YOUR_API_KEY biçimi kullandığını doğrulayın.
  2. Gerekli alanların mevcut ve geçerli olup olmadığını denetleyin.
  3. Oluşturma Zaman Günlüğü içinveya (duration ve startend onaylayın.

Değişiklik Kaydı

  • 1.0.0 – Sertifikasyon için ilk gönderim.

Support

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Authorization securestring Bu API için Yetkilendirme Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Ada Göre Etiket Bul

Adına göre bir etiket bulun.
Ada Göre Görev Bul

Ada ve proje kimliğine göre bir proje görevi bulun.
Etiket Oluştur

Yeni bir etiket oluşturun.
İstemci Oluştur

Yeni bir istemci kaydı oluşturun.
İstemciyi Ada Göre Bul

Sağlanan adla eşleşen istemcileri döndürür.
Proje Oluştur

Yeni bir proje oluşturma.
Project'e Görev Ekle

Seçili projede görev oluşturma.
Projeyi Ada Göre Bul

Projeyi ada göre bulun.
Zaman Günlüklerini Alma

Bir tarih aralığı için ayrıntılı etkinlik veya saat günlüklerini alın.
Zaman Günlüğü Oluştur

Bir Zaman Günlüğü oluşturun. 'duration' alanı veya 'başlangıç zamanı' ve 'bitiş saati' alanları doldurulmalıdır. Üçünün de doldurulması durumunda bir hata alırsınız

Ada Göre Etiket Bul

İşlem Kimliği:
FindTag

Adına göre bir etiket bulun.

Parametreler

Name Anahtar Gerekli Tür Description
Etiket adı
 tagName True string

Etiket adı.

Döndürülenler

Body
Tag

Ada Göre Görev Bul

İşlem Kimliği:
FindTask

Ada ve proje kimliğine göre bir proje görevi bulun.

Parametreler

Name Anahtar Gerekli Tür Description
Görev adı
 projectTaskName True string

Görev adı.
Proje Kimliği
 projectId True integer

Proje Kimliği.

Döndürülenler

Body
ProjectTask

Etiket Oluştur

İşlem Kimliği:
CreateTag

Yeni bir etiket oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
Etiket adı
 name True string

Etiket adı.
Onaltılık Renk
 hexColor True string

Onaltılık renk

Döndürülenler

Body
Tag

İstemci Oluştur

İşlem Kimliği:
CreateClient

Yeni bir istemci kaydı oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
İsim
 Name True string

İstemci adı.

Döndürülenler

Body
Client

İstemciyi Ada Göre Bul

İşlem Kimliği:
FindClient

Sağlanan adla eşleşen istemcileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
İstemci adı
 clientName True string

Tam veya kısmi eşleşmeye sahip istemci adı.

Döndürülenler

response
array of Client

Proje Oluştur

İşlem Kimliği:
CreateProject

Yeni bir proje oluşturma.

Parametreler

Name Anahtar Gerekli Tür Description
İsim
 name True string

Proje adı.
Müşteri Kimliği
 clientId integer

İstemci kodu.
Notes
 notes string

Notlar.
Atanan Kullanıcı
 autoAssignUserId integer

Projeye atanan kullanıcı.

Döndürülenler

Body
Project

Project'e Görev Ekle

İşlem Kimliği:
CreateProjectTask

Seçili projede görev oluşturma.

Parametreler

Name Anahtar Gerekli Tür Description
Proje Kimliği
 projectId True integer

Proje Kimliği.
Liste Adı
 listName string

Görev listesi adı.
İsim
 name True string

Görev adı.
Description
 description string

Açıklama.

Döndürülenler

Body
ProjectTask

Projeyi Ada Göre Bul

İşlem Kimliği:
FindProject

Projeyi ada göre bulun.

Parametreler

Name Anahtar Gerekli Tür Description
Proje adı
 projectName True string

Proje adı.

Döndürülenler

Body
Project

Zaman Günlüklerini Alma

İşlem Kimliği:
GetTimeLogs

Bir tarih aralığı için ayrıntılı etkinlik veya saat günlüklerini alın.

Parametreler

Name Anahtar Gerekli Tür Description
Başlangıç tarihi
 dateFrom True date

Başlangıç tarihi YYYY-MM-DD biçimindedir.
Tarih:
 dateTo True date

YYYY-MM-DD biçiminde bitiş tarihi.

Döndürülenler

Body
ActivityReportResponse

Zaman Günlüğü Oluştur

İşlem Kimliği:
CreateLog

Bir Zaman Günlüğü oluşturun. 'duration' alanı veya 'başlangıç zamanı' ve 'bitiş saati' alanları doldurulmalıdır. Üçünün de doldurulması durumunda bir hata alırsınız

Parametreler

Name Anahtar Gerekli Tür Description
Date
 date True date

YYYY-MM-DD biçiminde tarih.
Başlangıç saati
 start date-time

Başlangıç saati UTC veya yerel ISO 8601 biçimindedir.
Bitiş saati
 end date-time

Bitiş saati UTC veya yerel ISO 8601 biçimindedir.
Süre
 duration integer

Saniye cinsinden süre.
Description
 Note string

Not.
Proje Kimliği
 ProjectId integer

Proje Kimliği.
Görev Kimliği
 TaskId integer

Görev Kimliği.
Etiket Kimliği
 TagId integer

Etiket Kimliği.

Döndürülenler

Body
TimeLog

Tetikleyiciler

Yeni bir Görev oluşturulduğunda

Yeni bir proje görevi oluşturulduğunda tetikleme.
Yeni bir Proje oluşturulduğunda

Yeni bir proje oluşturulduğunda tetikleme.
Yeni bir Zaman Günlüğü oluşturulduğunda

Yeni bir zaman günlüğü oluşturulduğunda tetikleme.

Yeni bir Görev oluşturulduğunda

İşlem Kimliği:
NewTask

Yeni bir proje görevi oluşturulduğunda tetikleme.

Döndürülenler

Body
TriggerProjectTasksEnvelope

Yeni bir Proje oluşturulduğunda

İşlem Kimliği:
NewProject

Yeni bir proje oluşturulduğunda tetikleme.

Döndürülenler

Body
TriggerProjectsEnvelope

Yeni bir Zaman Günlüğü oluşturulduğunda

İşlem Kimliği:
NewTimeLog

Yeni bir zaman günlüğü oluşturulduğunda tetikleme.

Döndürülenler

Body
TriggerLogsEnvelope

Tanımlar

TimeSlice

Name Yol Tür Description
kimlik
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
koşmak
 running boolean
silindi
 deleted boolean

Attachment

Name Yol Tür Description
fileName
 fileName string
fileUrl
 fileUrl string
kimlik
 id integer

Etiket

Name Yol Tür Description
name
 name string
hexColor
 hexColor string
Arşivlenmiş
 archived boolean
dateArchived
 dateArchived string
kimlik
 id integer

Müşteri

Name Yol Tür Description
name
 name string
contactName (İletişim Adı)
 contactName string
iletişimE-posta adresi
 contactEmail string
İletişimTelefon
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
kimlik
 id integer

Project

Name Yol Tür Description
invoiceMethod
 invoiceMethod integer
oran
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
Notlar
 notes string
onaylı
 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
Faturalanabilir
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
name
 name string
Arşivlenmiş
 archived boolean
customId
 customId string
kimlik
 id integer

ProjectTask

Name Yol Tür Description
name
 name string
orderNo
 orderNo integer
açıklama
 description string
Tamamlandı
 completed boolean
Arşivlenmiş
 archived boolean
startDate
 startDate string
dueDate
 dueDate string
oran
 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
kimlik
 id integer

TimeLog

Name Yol Tür Description
not
 note string
date
 date string
duration
 duration integer
kullanıcı adı
 userName string
projectName (projeadı)
 projectName string
taskName
 taskName string
clientName
 clientName string
koşmak
 running boolean
startTime
 startTime string
endTime
 endTime string
kere
 times array of TimeSlice
statü
 status integer
projectId
 projectId integer
taskId
 taskId integer
Faturalanabilir
 billable boolean
gider
 expense float
userId
 userId integer
faturalanabilir Hızlı
 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
kimlik
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Name Yol Tür Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
kullanıcı adı
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
projectName (projeadı)
 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
görev Tamamlanmadı
 taskCompleted boolean
userCustomFieldValues
 userCustomFieldValues string
projectCustomFieldValues
 projectCustomFieldValues string
clientCustomFieldValues
 clientCustomFieldValues string
taskCustomFieldValues
 taskCustomFieldValues string
tags
 tags string
oran
 rate float
Faturalanabilir
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
miktar
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
gider
 expense float
billableExpense
 billableExpense float
maliyet
 cost float
not
 note string
statü
 status string
faturaNumarası
 invoiceId integer
Faturalanan
 invoiced boolean
billableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
denge
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
Takım
 teams array of string
koşmak
 running boolean
startTime
 startTime string
endTime
 endTime string
kere
 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 Yol Tür Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Name Yol Tür Description
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Name Yol Tür Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
name
 projects.name string
customId
 projects.customId string
kimlik
 projects.id integer

TriggerProjectTasksEnvelope

Name Yol Tür Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
name
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
açıklama
 projectTasks.description string
oran
 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
kimlik
 projectTasks.id integer