# 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.

| Ne | Adres |
|---|---|
| Web uygulaması | `https://<firma>.solk.app` |
| REST API | `https://<firma>.solk.app/api/v1/…` |
| MCP bağlayıcısı | `https://<firma>.solk.app/mcp` |
| OAuth keşfi | `https://<firma>.solk.app/.well-known/oauth-authorization-server` |
| SCIM 2.0 | `https://<firma>.solk.app/api/scim/v2` |
| Gelen kancalar | `https://<firma>.solk.app/in/<uygulama>/<gizli anahtar>` |
| Sürüm ve sağlık | `https://<firma>.solk.app/health` |
| Takvim (CalDAV) | `https://<firma>.solk.app/radicale/` |

Kurulum adresini bilmiyorsanız kullanıcılara sorun: tarayıcıda CRM'i açtıkları adres odur. [solk.app](https://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:

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

```json
{
  "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`](/rest-api/auth/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.