Tüm isteklerde X-Tenant header’ı zorunludur. İşlemler yalnızca belirtilen tenant’a ait kanal engel kayıtları ile sınırlandırılmıştır.
Endpoint özeti
| Metot | Endpoint | Açıklama |
|---|
GET | /api/v1/channel-blacklists | Engel listesini filtreli olarak listeler |
GET | /api/v1/channel-blacklists/{id} | Tek bir engel kaydını getirir |
POST | /api/v1/channel-blacklists | Yeni engel kaydı oluşturur |
PUT | /api/v1/channel-blacklists/{id} | Engel kaydını günceller |
DELETE | /api/v1/channel-blacklists/{id} | Engeli kaldırır |
Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın. Kanal engel listesi kavramı
Kanal engel listesi, belirli bir iletişim kanalı üzerinden gelen istenmeyen adresleri (spam, kötüye kullanım vb.) engellemek için kullanılır. Bir kayıt; engellenecek kanal, müşteri, engel nedeni (SpamType) ve opsiyonel olarak geçerlilik süresi (ttl_seconds) ile yönetilir.
İş kuralları
Engel süresi: ttl_seconds gönderilmezse engel kalıcıdır. Belirli bir süre için engellemek istiyorsanız saniye cinsinden değer gönderin (örn. 86400 → 1 gün).
DELETE kaydı silmez: DELETE /channel-blacklists/{id} işlemi kaydı veritabanından kaldırmaz; yalnızca is_active = false set eder (engeli kaldırır / unblock).
expires_at güncellemesi: PUT isteğinde expires_at alanı null gönderilirse mevcut süreli engel kalıcı engele dönüştürülür.
metadata birleştirme: PUT isteğinde gönderilen metadata, mevcut değerin üzerine yazılmaz; mevcut metadata ile merge edilir.
Yetkilendirme
Uygulama izinleri (permissions)
| İşlem | Permission |
|---|
| Listeleme | ViewAny:ChannelBlacklist |
| Detay / Tek gösterme | View:ChannelBlacklist |
| Oluşturma | Create:ChannelBlacklist |
| Güncelleme | Update:ChannelBlacklist |
| Engeli kaldırma (DELETE) | Delete:ChannelBlacklist |
Token scope’ları (Passport)
| İşlem | Scope |
|---|
Okuma (index, show) | channel_blacklists:read |
Yazma (store, update, destroy) | channel_blacklists:write |
