Ayarlar API

Tüm isteklerde X-Tenant header’ı zorunludur. Her kategori için ayarlar yalnızca belirtilen tenant’a aittir.

Endpoint özeti

Her ayar kategorisi aynı yapıya sahiptir: GET mevcut değerleri getirir, PUT günceller (merge ederek), DELETE /reset varsayılana sıfırlar.

Metot	Endpoint	Açıklama
`GET`	`/api/v1/settings/appointment`	Randevu ayarlarını getirir
`PUT`	`/api/v1/settings/appointment`	Randevu ayarlarını günceller
`DELETE`	`/api/v1/settings/appointment/reset`	Randevu ayarlarını sıfırlar
`GET`	`/api/v1/settings/notification`	Bildirim ayarlarını getirir
`PUT`	`/api/v1/settings/notification`	Bildirim ayarlarını günceller
`DELETE`	`/api/v1/settings/notification/reset`	Bildirim ayarlarını sıfırlar
`GET`	`/api/v1/settings/support`	Destek ayarlarını getirir
`PUT`	`/api/v1/settings/support`	Destek ayarlarını günceller
`DELETE`	`/api/v1/settings/support/reset`	Destek ayarlarını sıfırlar
`GET`	`/api/v1/settings/general`	Genel ayarları getirir
`PUT`	`/api/v1/settings/general`	Genel ayarları günceller
`DELETE`	`/api/v1/settings/general/reset`	Genel ayarları sıfırlar
`GET`	`/api/v1/settings/chat`	Chat ayarlarını getirir
`PUT`	`/api/v1/settings/chat`	Chat ayarlarını günceller
`DELETE`	`/api/v1/settings/chat/reset`	Chat ayarlarını sıfırlar
`GET`	`/api/v1/settings/accounting`	Muhasebe ayarlarını getirir
`PUT`	`/api/v1/settings/accounting`	Muhasebe ayarlarını günceller
`DELETE`	`/api/v1/settings/accounting/reset`	Muhasebe ayarlarını sıfırlar

Tüm alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın.

Ayar kategorileri

Randevu ayarları (`/settings/appointment`)

Randevu oluşturma limitleri, slot süresi ve ileriye dönük randevu penceresini yönetir.

Alan	Açıklama
`appointments.creation_limit`	Toplam randevu oluşturma limiti
`appointments.monthly_creation_limit`	Aylık limit
`appointments.slot_duration`	Slot süresi (dakika, min. 5)
`appointments.max_future_days`	Kaç gün sonrasına randevu oluşturulabilir

Bildirim ayarları (`/settings/notification`)

Hatırlatma ve seans onayı zamanlamalarını yönetir.

Alan	Açıklama
`reminders.appointment_offsets`	Randevu hatırlatması için negatif gün offsetleri (örn. `[-3, -1]`)
`reminders.session_confirmation_offsets`	Seans onayı offsetleri (30 günden kısa aralıklar için)
`reminders.session_confirmation_offsets_long_gap`	Seans onayı offsetleri (30+ gün aralıklar için)
`cancellation_followup_days`	İptal sonrası takip mesajı kaç gün sonra gönderilsin

Destek ayarları (`/settings/support`)

Alan	Açıklama
`support.response_time_minutes`	Hedef yanıt süresi (dakika, min. 30)

Genel ayarlar (`/settings/general`)

Alan	Açıklama
`default_timezone`	Saat dilimi (örn. `Europe/Istanbul`)
`date_format`	Tarih formatı: `d/m/Y`, `m/d/Y` veya `Y-m-d`
`time_format`	Saat formatı: `H:i` veya `h:i A`
`currency`	Aktif para birimi kodu (örn. `TRY`)
`locale`	Dil kodu (örn. `tr`)

Chat ayarları (`/settings/chat`)

Şifre doğrulaması zorunludur: PUT /settings/chat isteğinde mevcut kullanıcının password alanını göndermek zorunludur.

Alan	Açıklama
`ai_reply_windows`	AI yanıt programı — gün, başlangıç/bitiş saati ve mod (`auto`, `semi_auto`, `closed`) ile tanımlanan zaman dilimleri
`pre_booking_requirements.enabled`	Ön rezervasyon gereksinimi
`customer_forms.default_template_id`	Varsayılan aktif form şablonu ID’si

ai_reply_windows içinde çakışan zaman dilimleri validation’da reddedilir. Her ai_reply_windows girişinde end_time, start_time’dan sonra olmalıdır.

Muhasebe ayarları (`/settings/accounting`)

Alan	Açıklama
`default_tax_rate`	Varsayılan KDV oranı (0-100)

Yetkilendirme

Settings endpoint’lerinde rol tabanlı izin kontrolü (ViewAny:Resource vb.) uygulanmaz — erişim kontrolü tamamen token scope seviyesinde yapılır. Tüm settings endpoint’leri middleware('tenant') gerektirdiğinden aktif bir tenant bağlamı zorunludur.

Token scope’ları (Passport)

İşlem	Scope
Okuma (`GET`)	`settings:read`
Yazma (`PUT`, `DELETE /reset`)	`settings:write`

Başlarken

Kimlik Doğrulama

Multi-Tenancy

İstekler

Hesap & Yetki

Kullanıcılar

Hasta Yönetimi

Randevu & Tedavi

Mesajlaşma

Operasyon & Loglar

Satış & Finans

Ürün Yönetimi

Stok Yönetimi

Ayarlar

AI

Realtime

Entegrasyonlar

Rehberler

Kaynaklar

Endpoint özeti

Ayar kategorileri

Randevu ayarları (`/settings/appointment`)

Bildirim ayarları (`/settings/notification`)

Destek ayarları (`/settings/support`)

Genel ayarlar (`/settings/general`)

Chat ayarları (`/settings/chat`)

Muhasebe ayarları (`/settings/accounting`)

Yetkilendirme

Token scope’ları (Passport)

​Endpoint özeti

​Ayar kategorileri

​Randevu ayarları (/settings/appointment)

​Bildirim ayarları (/settings/notification)

​Destek ayarları (/settings/support)

​Genel ayarlar (/settings/general)

​Chat ayarları (/settings/chat)

​Muhasebe ayarları (/settings/accounting)

​Yetkilendirme

​Token scope’ları (Passport)

Endpoint özeti

Ayar kategorileri

Randevu ayarları (`/settings/appointment`)

Bildirim ayarları (`/settings/notification`)

Destek ayarları (`/settings/support`)

Genel ayarlar (`/settings/general`)

Chat ayarları (`/settings/chat`)

Muhasebe ayarları (`/settings/accounting`)

Yetkilendirme

Token scope’ları (Passport)