Kurulumlar ve adresler

Her firmanın Solk kurulumu ayrı bir adreste çalışır. API, MCP, kanca ve keşif adresleri bu adresten türer.

Solk'ta "çalışma alanı" yerine kurulum vardır: her müşteri firmanın kendi alt alan adı, kendi veritabanı ve kendi ayarları olur. Ortak bir API sunucusu yoktur; isteklerinizi doğrudan kurulumun adresine gönderirsiniz.

Kurulum adresini bilmiyorsanız kullanıcılara sorun: tarayıcıda CRM'i açtıkları adres odur. solk.app giriş sayfası firma adını yazınca doğru kuruluma yönlendirir.

Sürüm

Kurulumlar aynı kod tabanından güncellenir; ancak her kurulum kendi takviminde güncellendiği için bir an iki kurulum farklı sürümde olabilir. Çalışan sürümü öğrenmek için:

curl https://ornek.solk.app/health

{
  "ok": true,
  "version": "v22",
  "code": "bff893f1",
  "started": "2026-10-02T09:12:40",
  "restart_needed": false,
  "time": "2026-10-02T14:20:03",
  "schema_missing": {},
  "last_backup": "2026-10-02",
  "last_sync": "2026-10-02T14:10"
}

API'de yeni bir alan ya da uç kullanmadan önce sürümü kontrol etmek, eski sürümdeki bir kurulumda 404 almanızı önler. Yeni alanlar yanıtlara eklenir; mevcut alanların anlamı değişmez ve kaldırılmaz.

Lisans ve modüller

Her kurulumun lisansı hangi modüllerin açık olduğunu belirler: Müşteriler, Fırsatlar, Ziyaretler, Görevler, Takvim, Fuar leadleri, Raporlar, Satış öngörüsü, Destek talepleri, Sözleşmeler, E-posta otomasyonu, Yapay zekâ. Kapalı bir modülün uçları 403 module döner. Açık modüller GET /api/v1/me yanıtında license.modules ve kullanıcıya özel user.modules alanlarındadır.

Lisans süresi dolduğunda kurulum yalnız yöneticiye açık kalır; diğer kullanıcıların API istekleri 403 license alır.

Saat dilimi ve tarih biçimi

Kurulumlar Türkiye saatiyle (UTC+3) çalışır. API tarihleri YYYY-MM-DD, tarih-saatleri saat dilimi eki olmadan YYYY-MM-DDTHH:MM:SS (yerel saat) biçiminde verir ve bekler. Gelen kancalarda ISO 8601 (dilim ekli) ya da Unix zaman damgası gönderebilirsiniz; yerel saate çevrilir.