> For the complete documentation index, see [llms.txt](https://kilavuz.cubicl.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kilavuz.cubicl.io/api-entegrasyonu/raporlar.md).

# Raporlar

Proje zamanlayıcı kayıtları ve görevlerin aşamalarda geçirdiği süreler. Projede rapor görüntüleme izni gerekir.

## Zaman raporunu getir

> Proje ve tarih aralığındaki bitmiş zamanlayıcı kayıtlarını getirir. Rapor izni gerekir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Raporlar","description":"Proje zamanlayıcı kayıtları ve görevlerin aşamalarda geçirdiği süreler. Projede rapor görüntüleme izni gerekir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"TimerList":{"type":"array","items":{"$ref":"#/components/schemas/Timer"}},"Timer":{"type":"object","properties":{"_id":{"type":"string"},"task":{"$ref":"#/components/schemas/TimeReportTask"},"user":{"type":"string"},"group":{"type":"string"},"start":{"type":"number"},"end":{"type":"number"},"createdAt":{"type":"number"},"updatedAt":{"type":"number"}}},"TimeReportTask":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"},"state":{"type":"string"},"priority":{"type":"number"},"assignedBy":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"parent":{"description":"`fetch=parent` ise görev nesnesi olabilir"},"subtasks":{"description":"`fetch=subtasks` ise görev nesneleri olabilir"},"steps":{"type":"array","items":{"type":"object"}},"stepType":{"type":"string"},"completedAt":{"type":"number"},"private":{"type":"boolean"},"estimatedTime":{"type":"number"},"trackingNumber":{"type":"string"},"breadcrumbs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"}}}}}},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/reports/timers":{"get":{"tags":["Raporlar"],"summary":"Zaman raporunu getir","description":"Proje ve tarih aralığındaki bitmiş zamanlayıcı kayıtlarını getirir. Rapor izni gerekir.","operationId":"getTimerReport","parameters":[{"name":"group","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Proje ID'si"},{"name":"from","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UnixTimestamp"},"description":"Başlangıç (Unix saniye)"},{"name":"to","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UnixTimestamp"},"description":"Bitiş (Unix saniye)"},{"name":"recursive","in":"query","required":true,"schema":{"type":"string","enum":["true","false"]},"description":"`\"true\"`: alt projeler dahil. `\"false\"`: yalnızca verilen proje."},{"name":"archived","in":"query","schema":{"type":"string","enum":["true","false","all"]},"description":"`true`: arşivli. `false`: arşivsiz. `all`: tümü."},{"name":"fetch","in":"query","schema":{"type":"string"},"description":"Virgülle ayrılmış ek veri: `parent`, `subtasks`"},{"name":"user","in":"query","schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Zamanlayıcıyı oluşturan kullanıcı ID'si. Verilmezse tüm kullanıcılar."},{"name":"skip","in":"query","schema":{"type":"number","minimum":0},"description":"Atlanacak kayıt sayısı. En az 0. Verilmezse atlama yok."},{"name":"limit","in":"query","schema":{"type":"number","minimum":1},"description":"Döndürülecek kayıt sayısı. En az 1. Verilmezse sınır yok."}],"responses":{"200":{"description":"Zaman raporu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimerList"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## Görev aşama sürelerini getir

> Projedeki görevlerin aşamalarda geçirdiği süreleri getirir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Raporlar","description":"Proje zamanlayıcı kayıtları ve görevlerin aşamalarda geçirdiği süreler. Projede rapor görüntüleme izni gerekir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"},"TaskStageTimeList":{"type":"array","items":{"$ref":"#/components/schemas/TaskStageTime"}},"TaskStageTime":{"type":"object","description":"`type=task`: her öğe görev. `type=user`: her öğe kullanıcı; `assignees` ve `lastState` dönmez. `stateStats` saniye cinsinden, anahtarlar aşama adları.","properties":{"_id":{"type":"string"},"name":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}},"lastState":{"type":"string"},"stateStats":{"type":"object","additionalProperties":{"type":"number"}}}},"ErrorCode":{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ForbiddenCode":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/reports/task-stage-times":{"get":{"tags":["Raporlar"],"summary":"Görev aşama sürelerini getir","operationId":"getTaskStageTimes","parameters":[{"name":"group","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ObjectId"},"description":"Proje ID'si"},{"name":"start","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UnixTimestamp"},"description":"Başlangıç (Unix saniye)"},{"name":"end","in":"query","required":true,"schema":{"$ref":"#/components/schemas/UnixTimestamp"},"description":"Bitiş (Unix saniye)"},{"name":"type","in":"query","schema":{"type":"string","enum":["user","task"]},"description":"Raporun gruplanması: `user` veya `task`"},{"name":"archived","in":"query","schema":{"type":"string","enum":["true","false","all"]},"description":"`true`: arşivli. `false`: arşivsiz. `all`: tümü."}],"responses":{"200":{"description":"Aşama süresi raporu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStageTimeList"}}}},"403":{"$ref":"#/components/responses/ForbiddenCode"},"422":{"$ref":"#/components/responses/ValidationFailed"}},"description":"Projedeki görevlerin aşamalarda geçirdiği süreleri getirir."}}}}
```

## ID'lere göre görev aşama sürelerini getir

> Birden fazla görevin aşama sürelerini getirir. Görevler farklı projelerde olabilir; her proje için rapor izni gerekir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Raporlar","description":"Proje zamanlayıcı kayıtları ve görevlerin aşamalarda geçirdiği süreler. Projede rapor görüntüleme izni gerekir."}],"servers":[{"url":"https://cubicl.io/api/v1","description":"Cubicl production API"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Entegrasyonlar sayfasından alınan erişim jetonu. Header: `Authorization: Bearer ERİŞİM_JETONUNUZ`."}},"schemas":{"GetTaskStageTimesByIdsRequest":{"type":"object","required":["taskIds","start","end"],"properties":{"taskIds":{"type":"array","items":{"type":"string"},"description":"Görev ID listesi"},"start":{"type":"number","description":"Başlangıç (Unix saniye)"},"end":{"type":"number","description":"Bitiş (Unix saniye)"},"type":{"type":"string","enum":["user","task"],"description":"Raporun gruplanması: `user` veya `task`"}}},"TaskStageTimeList":{"type":"array","items":{"$ref":"#/components/schemas/TaskStageTime"}},"TaskStageTime":{"type":"object","description":"`type=task`: her öğe görev. `type=user`: her öğe kullanıcı; `assignees` ve `lastState` dönmez. `stateStats` saniye cinsinden, anahtarlar aşama adları.","properties":{"_id":{"type":"string"},"name":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}},"lastState":{"type":"string"},"stateStats":{"type":"object","additionalProperties":{"type":"number"}}}},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}},"ErrorMessage":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}},"NotFound":{"description":"Kaynak bulunamadı"}}},"paths":{"/reports/task-stage-times-by-ids":{"post":{"tags":["Raporlar"],"summary":"ID'lere göre görev aşama sürelerini getir","description":"Birden fazla görevin aşama sürelerini getirir. Görevler farklı projelerde olabilir; her proje için rapor izni gerekir.","operationId":"getTaskStageTimesByIds","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTaskStageTimesByIdsRequest"}}}},"responses":{"200":{"description":"Aşama süresi raporu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStageTimeList"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"description":"Geçersiz işlem","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ErrorMessage"},{"$ref":"#/components/schemas/ValidationError"}]}}}}}}}}}
```
