> 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/kullanicilar.md).

# Kullanıcılar

Kurum kullanıcılarını ve kimliği doğrulanmış hesabı getirir. Görevler ve diğer kayıtlardaki kullanıcı ID'leri Cubicl kullanıcılarının yanı sıra müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Cubicl, kurumdan çıkarılan kullanıcıların oluşturduğu verileri saklamaya devam eder; ayrıntıları ID listesiyle alabilirsiniz.

## Tüm kullanıcıları getir

> Şu anda kurumda olan tüm kullanıcıları getirir. Görevler ve diğer kayıtlar, kurumdan çıkarılan veya müşteri portalı kullanıcıları olan kullanıcılara atıfta bulunabilir. Kullanıcılar ile ilgili ayrıntı almak için \*\*ID'lere göre kullanıcıları getir\*\* adresini kullanın.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Kullanıcılar","description":"Kurum kullanıcılarını ve kimliği doğrulanmış hesabı getirir. Görevler ve diğer kayıtlardaki kullanıcı ID'leri Cubicl kullanıcılarının yanı sıra müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Cubicl, kurumdan çıkarılan kullanıcıların oluşturduğu verileri saklamaya devam eder; ayrıntıları ID listesiyle alabilirsiniz."}],"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":{"UserList":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"User":{"type":"object","description":"`User`, `PortalUser` ve `EmailUser` bu formatı paylaşır. Profil yolu `/assets/img/...` ise başına `https://cubicl.io` ekleyin.","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"email":{"type":"string"},"firstname":{"type":"string"},"lastname":{"type":"string"},"profile":{"type":"string","description":"Profil fotoğrafı URL'si"}}},"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"ErrorCodeMessage":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","description":"Uygulama hata kodu. HTTP durum kodu değildir."},"message":{"type":"string"}}}},"responses":{"Forbidden":{"description":"İzin yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCodeMessage"}}}}}},"paths":{"/organization/users":{"get":{"tags":["Kullanıcılar"],"summary":"Tüm kullanıcıları getir","description":"Şu anda kurumda olan tüm kullanıcıları getirir. Görevler ve diğer kayıtlar, kurumdan çıkarılan veya müşteri portalı kullanıcıları olan kullanıcılara atıfta bulunabilir. Kullanıcılar ile ilgili ayrıntı almak için **ID'lere göre kullanıcıları getir** adresini kullanın.","operationId":"listOrganizationUsers","responses":{"200":{"description":"Kullanıcı listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserList"}}}},"403":{"$ref":"#/components/responses/Forbidden"}}}}}}
```

## ID'lere göre kullanıcıları getir

> ID'leri verilen kullanıcıları döndürür.\
> \
> Cubicl, kullanıcılar tarafından oluşturulan (gönderilen sohbet mesajları, görev yorumları vb.) ve ilgili (atanan görevler vb.) verileri, kurum hesabından çıkarıldıktan sonra bile saklar. Ayrıntılarına erişmek için bu uç noktayı kullanabilirsiniz.\
> \
> Kayıtlardaki kullanıcı ID'leri sadece Cubicl kullanıcılarını değil aynı zamanda müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Bu adres onları da göstermektedir.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Kullanıcılar","description":"Kurum kullanıcılarını ve kimliği doğrulanmış hesabı getirir. Görevler ve diğer kayıtlardaki kullanıcı ID'leri Cubicl kullanıcılarının yanı sıra müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Cubicl, kurumdan çıkarılan kullanıcıların oluşturduğu verileri saklamaya devam eder; ayrıntıları ID listesiyle alabilirsiniz."}],"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":{"UserList":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"User":{"type":"object","description":"`User`, `PortalUser` ve `EmailUser` bu formatı paylaşır. Profil yolu `/assets/img/...` ise başına `https://cubicl.io` ekleyin.","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"email":{"type":"string"},"firstname":{"type":"string"},"lastname":{"type":"string"},"profile":{"type":"string","description":"Profil fotoğrafı URL'si"}}},"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"ValidationError":{"type":"object","properties":{"message":{"type":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"responses":{"ValidationFailed":{"description":"Doğrulama başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/users":{"get":{"tags":["Kullanıcılar"],"summary":"ID'lere göre kullanıcıları getir","description":"ID'leri verilen kullanıcıları döndürür.\n\nCubicl, kullanıcılar tarafından oluşturulan (gönderilen sohbet mesajları, görev yorumları vb.) ve ilgili (atanan görevler vb.) verileri, kurum hesabından çıkarıldıktan sonra bile saklar. Ayrıntılarına erişmek için bu uç noktayı kullanabilirsiniz.\n\nKayıtlardaki kullanıcı ID'leri sadece Cubicl kullanıcılarını değil aynı zamanda müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Bu adres onları da göstermektedir.","operationId":"listUsersByIds","parameters":[{"name":"ids","in":"query","required":true,"description":"Virgülle ayrılmış ID listesi","schema":{"type":"string"}}],"responses":{"200":{"description":"Kullanıcı listesi","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserList"}}}},"422":{"$ref":"#/components/responses/ValidationFailed"}}}}}}
```

## Kullanıcı bilgilerimi getir

> Kimliği doğrulanmış mevcut kullanıcıya ait bilgileri döndürür.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Kullanıcılar","description":"Kurum kullanıcılarını ve kimliği doğrulanmış hesabı getirir. Görevler ve diğer kayıtlardaki kullanıcı ID'leri Cubicl kullanıcılarının yanı sıra müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Cubicl, kurumdan çıkarılan kullanıcıların oluşturduğu verileri saklamaya devam eder; ayrıntıları ID listesiyle alabilirsiniz."}],"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":{"CurrentUser":{"allOf":[{"$ref":"#/components/schemas/User"},{"type":"object","properties":{"language":{"type":"string"},"jobTitle":{"type":"string","nullable":true},"localization":{"type":"object","properties":{"dateFormat":{"type":"string"},"timeFormat":{"type":"string"},"timezone":{"type":"number"}}},"org":{"type":"object","properties":{"_id":{"type":"string"},"name":{"type":"string"},"countryCode":{"type":"string"},"isAdmin":{"type":"boolean"}}},"presence":{"type":"object","properties":{"status":{"type":"string","enum":["busy","in-meeting","dnd","on-leave","none"]},"doNotDisturb":{"type":"object","description":"`status = dnd` ise tanımlıdır.","properties":{"mode":{"type":"string","enum":["off","duration","customHours"]},"preset":{"type":"string","enum":["off","15m","30m","1h","2h","4h","untilDisabled","custom"]},"customStart":{"type":"number"},"customEnd":{"type":"number"}}}}}}}]},"User":{"type":"object","description":"`User`, `PortalUser` ve `EmailUser` bu formatı paylaşır. Profil yolu `/assets/img/...` ise başına `https://cubicl.io` ekleyin.","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"email":{"type":"string"},"firstname":{"type":"string"},"lastname":{"type":"string"},"profile":{"type":"string","description":"Profil fotoğrafı URL'si"}}},"ObjectId":{"type":"string","description":"MongoDB ObjectId"}}},"paths":{"/app/me":{"get":{"tags":["Kullanıcılar"],"summary":"Kullanıcı bilgilerimi getir","operationId":"getCurrentUser","responses":{"200":{"description":"Kimliği doğrulanmış kullanıcı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentUser"}}}}},"description":"Kimliği doğrulanmış mevcut kullanıcıya ait bilgileri döndürür."}}}}
```

## Oturumları getir

> Kimliği doğrulanmış kullanıcının oturum kayıtlarını getirir. Başarılı oturumlar \`active\`, son iki aydaki şüpheli/başarısız oturumlar \`suspicious\` dizisinde döner.

```json
{"openapi":"3.0.3","info":{"title":"Cubicl API","version":"1.0.0"},"tags":[{"name":"Kullanıcılar","description":"Kurum kullanıcılarını ve kimliği doğrulanmış hesabı getirir. Görevler ve diğer kayıtlardaki kullanıcı ID'leri Cubicl kullanıcılarının yanı sıra müşteri portalı kullanıcılarına veya e-posta gönderenlere de ait olabilir. Cubicl, kurumdan çıkarılan kullanıcıların oluşturduğu verileri saklamaya devam eder; ayrıntıları ID listesiyle alabilirsiniz."}],"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":{"LoginSessionLists":{"type":"object","properties":{"active":{"type":"array","items":{"$ref":"#/components/schemas/LoginSession"}},"suspicious":{"type":"array","items":{"$ref":"#/components/schemas/LoginSession"}}}},"LoginSession":{"type":"object","properties":{"_id":{"$ref":"#/components/schemas/ObjectId"},"device":{"type":"string"},"deviceType":{"type":"string","enum":["desktop","phone","tablet","robot","other"]},"os":{"type":"string"},"browser":{"type":"string"},"loginTime":{"$ref":"#/components/schemas/UnixTimestamp"},"ipAddress":{"type":"string"},"location":{"type":"string"},"isSuccessful":{"type":"boolean"},"failureType":{"type":"string","enum":["wrong-password","two-fa-code-invalid","unknown-location"]},"isUserConfirmed":{"type":"boolean"}}},"ObjectId":{"type":"string","description":"MongoDB ObjectId"},"UnixTimestamp":{"type":"number","description":"Unix zaman damgası (saniye)"}}},"paths":{"/users/self/sessions":{"get":{"tags":["Kullanıcılar"],"summary":"Oturumları getir","operationId":"listCurrentUserSessions","description":"Kimliği doğrulanmış kullanıcının oturum kayıtlarını getirir. Başarılı oturumlar `active`, son iki aydaki şüpheli/başarısız oturumlar `suspicious` dizisinde döner.","responses":{"200":{"description":"Oturum listeleri","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginSessionLists"}}}}}}}}}
```
