Admin Operations

Admin sistem işlemleri endpoint'leri.

---

Muhasebe Entegrasyonu Başlat

Muhasebe entegrasyonunu başlatır.

Authentication

• x-auth (tenant-id)

HTTP Request

POST /integration/begin-accounting-integration

Request Parameters

Field	Type	Required	Default	Desc
startDate	date	true	-	Başlangıç tarihi
endDate	date	true	-	Bitiş tarihi
invoiceDate	date	true	-	Fatura tarihi

Request Body Example

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "invoiceDate": "2025-02-01"
}

---

Parametreleri Getir

Sistem parametrelerini getirir.

Authentication

• x-auth (tenant-id)

HTTP Request

GET /admin/get-parameters

Request Parameters

Field	Type	Required	Default	Desc
id	string	false	-	Parametre ID
code	string	false	-	Parametre kodu
isEditable	boolean	false	-	Düzenlenebilir filtresi

---

Parametreleri Güncelle

Sistem parametrelerini günceller (OTP doğrulaması gerektirir).

Authentication

• x-auth (tenant-id)
• OTP doğrulaması

HTTP Request

POST /admin/update-parameters

Request Parameters

Field	Type	Required	Default	Desc
id	string	true	-	Parametre ID
json	object	true	-	Yeni parametre değerleri

Request Body Example

{
  "id": "param_123",
  "json": {
    "key1": "value1",
    "key2": 123
  }
}

---

Sözleşmeleri Getir

Kullanıcı sözleşmelerini getirir.

Authentication

• x-auth (tenant-id)

HTTP Request

GET /admin/get-agreements

Request Parameters

Field	Type	Required	Default	Desc
version	string	false	-	Sözleşme versiyonu
userId	string	true	-	Kullanıcı ID

---

Hizmet Şartları Yükle

Yeni hizmet şartları belgesi yükler.

Authentication

• x-auth (tenant-id)

HTTP Request

POST /admin/terms-of-service

Request Parameters

Field	Type	Required	Default	Desc
base64String	string	true	-	Base64 kodlanmış dosya
name	string	true	-	Sözleşme adı
description	string	true	-	Sözleşme açıklaması
version	string	false	-	Versiyon numarası
sendEmail	boolean	false	-	E-posta gönderilsin mi
isAcceptRequired	boolean	false	-	Kullanıcı kabulü gerekli mi
userId	string	true	-	Oluşturan kullanıcı ID

İşlem Akışı

1. Dosya MinIO'ya yüklenir
2. sendEmail=true ise kullanıcılara e-posta gönderilir
3. E-postalar 800'lük gruplar halinde gönderilir
4. Sözleşme eki e-postaya eklenir

---

Bildirim Gönder

Kullanıcılara bildirim gönderir (OTP doğrulaması gerektirir).

Authentication

• x-auth (tenant-id)
• OTP doğrulaması

HTTP Request

POST /admin/send-notification

Request Parameters

Field	Type	Required	Default	Desc
memberId	string/array	true	-	Alıcı kullanıcı ID'leri
topic	string	true	-	Bildirim konusu
title	string	true	-	Bildirim başlığı
body	string	true	-	Bildirim içeriği
imageUrl	string	false	-	Görsel URL
clickActionType	string	false	-	Tıklama aksiyonu
operatingSystem	string	false	-	Hedef işletim sistemi
language	string	false	-	Dil tercihi

Request Body Example

{
  "memberId": ["user_123", "user_456"],
  "topic": "kampanya",
  "title": "Yeni Kampanya!",
  "body": "Kripto alımlarında %10 bonus kazanın.",
  "imageUrl": "https://cdn.example.com/campaign.png"
}

---

Toplu SMS Gönder

Kullanıcılara toplu SMS gönderir.

Authentication

• x-auth (tenant-id)

HTTP Request

POST /send-bulk-sms

Request Parameters

Field	Type	Required	Default	Desc
userIds	array	cond	-	Alıcı kullanıcı ID'leri
sendAllUsers	boolean	cond	-	Tüm kullanıcılara gönder
messageBody	string	true	-	SMS mesaj içeriği
filter	object	false	-	Filtreleme kriterleri

Request Body Example

{
  "userIds": ["user_123", "user_456"],
  "messageBody": "Hoşgeldiniz! Hesabınız aktif edildi."
}

Notlar

• userIds veya sendAllUsers: true sağlanmalıdır
• Sadece countryCode "90" (Türkiye) olan kullanıcılara gönderilir

---

CDN Yükleme

CDN'e dosya yükler.

Authentication

• x-auth (tenant-id)

HTTP Request

POST /admin/cdn/upload

Request Parameters

Field	Type	Required	Default	Desc
imageData	string	true	-	Base64 kodlanmış görsel
imageName	string	true	-	Görsel dosya adı
folderType	string	true	-	Klasör tipi (CDN parametresine göre)
useSuffix	boolean	false	true	Timestamp suffix eklensin mi

Request Body Example

{
  "imageData": "data:image/png;base64,iVBORw0KGgo...",
  "imageName": "banner",
  "folderType": "campaign",
  "useSuffix": true
}

Response Parameters

Field	Type	Nullable	Desc
data.imageUrl	string	true	Yüklenen görsel URL

Notlar

• folderType CDN parametre yapılandırmasına göre doğrulanır
• useSuffix: true ise dosya adına _${Date.now()} eklenir