API Referansı: Organizasyon Yönetimi
Organization Endpoints
Organizasyonlar, birden fazla tenant’ı aynı çatı altında toplar.
Get Organization
Bir tenant’ın bağlı olduğu organizasyon bilgilerini alın.
Endpoint: GET /tenant/{tenantId}/organization
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Tenant’ın benzersiz kimliği |
Response:
{
"id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"displayName": "Acme Corporation",
"createdAt": "2023-06-01T00:00:00Z"
}
Get Organization Statistics
Tüm organizasyonun toplu istatistiklerini alın.
Endpoint: GET /tenant/{tenantId}/organization/statistics
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Tenant’ın benzersiz kimliği |
Response:
{
"tenantCount": 5,
"totalProcessCount": 42,
"totalDatasetCount": 18,
"totalUserCount": 25,
"totalStorageUsedBytes": 5368709120
}
List Organization Tenants
Organizasyondaki tüm tenant’ları listeleyin.
Endpoint: GET /tenant/{tenantId}/organization/tenants
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Tenant’ın benzersiz kimliği |
Response:
[
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"displayName": "Sales Department",
"createdAt": "2024-01-01T00:00:00Z"
},
{
"id": "d4e5f6a7-b8c9-0123-def4-567890123456",
"displayName": "Operations",
"createdAt": "2024-02-15T00:00:00Z"
}
]
Create Tenant
Organizasyon içinde yeni bir tenant oluşturun.
Endpoint: POST /tenant/{tenantId}/organization/tenants
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Organizasyonda mevcut bir tenant’ın benzersiz kimliği |
Request Body:
{
"shortName": "sales-team",
"displayName": "Sales Team",
"description": "Satış departmanı için tenant"
}
| Field | Type | Required | Description |
|---|---|---|---|
| shortName | string | Evet | URL’e uygun kimlik (küçük harf, tire kullanılabilir) |
| displayName | string | Hayır | Tenant için okunabilir ad |
| description | string | Hayır | Tenant açıklaması |
Response: Oluşturulan tenant nesnesini döndürür.
Delete Tenant
Bir tenant’ı organizasyondan silin.
Endpoint: DELETE /tenant/{tenantId}/organization/tenants/{targetTenantId}
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Organizasyonda mevcut bir tenant’ın kimliği |
| targetTenantId | string | path | Evet | Silinecek tenant’ın benzersiz kimliği |
Response:
{
"success": true
}
warning
Bir tenant’ı silmek, ona ait tüm process, dataset ve kullanıcı atamalarını kalıcı olarak kaldırır. Bu işlem geri alınamaz. Kimlik doğrulaması yaptığınız tenant’ı silemezsiniz.
Organization Users Endpoints
List Organization Users
Organizasyondaki tüm kullanıcıları listeleyin.
Endpoint: GET /tenant/{tenantId}/organization/users
Parameters:
| Name | Type | Location | Required | Description |
|---|---|---|---|---|
| tenantId | string | path | Evet | Tenant’ın benzersiz kimliği |
Response:
[
{
"id": "e5f6a7b8-c9d0-1234-efa5-678901234567",
"email": "admin@example.com",
"firstName": "Jane",
"lastName": "Smith",
"createdAt": "2023-06-01T00:00:00Z",
"lastLoginAt": "2024-03-01T10:00:00Z",
"organizationId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"isActiveInOrganization": true,
"isAdminInOrganization": true
}
]
Update Organization User
Bir kullanıcının organizasyon içindeki izinlerini güncelleyin.
Endpoint: PUT /tenant/{tenantId}/organization/users
Request Body:
{
"userId": "e5f6a7b8-c9d0-1234-efa5-678901234567",
"organizationId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"isActiveInOrganization": true,
"isAdminInOrganization": true
}
| Field | Type | Required | Description |
|---|---|---|---|
| userId | string | Evet | Kullanıcının benzersiz kimliği |
| organizationId | string | Evet | Organizasyonun benzersiz kimliği |
| isActiveInOrganization | boolean | Hayır | Kullanıcı organizasyonda aktif mi |
| isAdminInOrganization | boolean | Hayır | Kullanıcı organizasyonda admin yetkisine sahip mi |
Response:
{
"message": "Kullanıcı organizasyon ayarları güncellendi."
}
Remove Organization User
Bir kullanıcıyı organizasyondan tamamen kaldırın.
Endpoint: DELETE /tenant/{tenantId}/organization/users
Request Body:
{
"userId": "e5f6a7b8-c9d0-1234-efa5-678901234567",
"organizationId": "c3d4e5f6-a7b8-9012-cdef-345678901234"
}
| Field | Type | Required | Description |
|---|---|---|---|
| userId | string | Evet | Kaldırılacak kullanıcının benzersiz kimliği |
| organizationId | string | Evet | Organizasyonun benzersiz kimliği |
Response:
{
"message": "Kullanıcı organizasyondan kaldırıldı."
}
warning
Bir kullanıcıyı organizasyondan kaldırmak, kişinin organizasyondaki tüm tenant’lara erişimini kaldırır.