Aktivite logları, giriş kayıtları ve geri dönüşüm kutusu

Bu sayfa üç ilişkili kaynağı anlatır. Aktivite logları kliniğinizde “kim, neyi, ne zaman değiştirdi” sorusunun cevabıdır. Giriş kayıtları klinik kullanıcılarının oturum açma ve kapatma denemelerini listeler. Geri dönüşüm kutusu silinen kayıtları saklama süresi dolana kadar geri yüklemenizi sağlar. Aktivite logları ve giriş kayıtları salt okunurdur; API’den kayıt ekleyemez, değiştiremez veya silemezsiniz. Tüm isteklerde Authorization: Bearer <access_token> ve X-Tenant: <tenant_id> başlıkları gerekir. Taban adres https://app.flextell.ai/api/v1 şeklindedir. Panelde aynı bilgiler için Aktivite Logları, Kullanıcı Girişleri ve Geri Dönüşüm Kutusu sayfaları vardır.

Endpoint özeti

Metot	Endpoint	Açıklama	Scope	İzin
`GET`	`/activity-logs`	Aktivite loglarını listeler	`activity_logs:read`	`View:ActivityLog`
`GET`	`/activity-logs/{id}`	Tek bir aktivite logunu getirir	`activity_logs:read`	`View:ActivityLog`
`GET`	`/authentication-logs`	Klinik kullanıcılarının giriş kayıtlarını listeler	`authentication_logs:read`	`View:AuthenticationLog`
`GET`	`/recycle-bin`	Geri dönüşüm kutusundaki kayıtları listeler	`recycle_bin:read`	`View:RecycleBin`
`POST`	`/recycle-bin/{id}/restore`	Kaydı (ve birlikte silinenleri) geri yükler	`recycle_bin:write`	`Restore:RecycleBin`
`DELETE`	`/recycle-bin/{id}/purge`	Kaydı kalıcı olarak siler	`recycle_bin:write`	`Purge:RecycleBin`

İzinler istekte X-Tenant ile seçilen klinikte kontrol edilir. İzne yalnızca başka bir klinikte sahipseniz 403 FORBIDDEN alırsınız. İzin etiketleri rol editöründe Aktivite Logları, Kullanıcı Girişleri ve Geri Dönüşüm Kutusu olarak görünür; geri dönüşüm için eylemler Geri Yükle ve Kalıcı Sil adını taşır. Genel kurallar için izinler ve görünürlük, scope’lar ve klinik seçimi sayfalarına bakın.

Ayrı bir “yalnızca kendi kayıtlarım” izni yoktur. View:ActivityLog izni olan kullanıcı, diğer modüllerdeki görünürlük kısıtlarından bağımsız olarak kliniğin tüm aktivitesini okur. Örneğin yalnızca kendi randevularını görebilen bir kullanıcı, View:ActivityLog ile tüm randevuların değişiklik geçmişini de okuyabilir. Bu izni dikkatle verin.

Aktivite logları

Bir aktivite logu, kliniğinizdeki bir kaydın oluşturulmasını, güncellenmesini veya silinmesini kaydeder. Hasta, randevu, Lead, satış, teklif, fatura, destek talebi, etiket, rol, kanal, ürün ve depo gibi birçok kayıt türü loglanır. Platform yöneticilerinin yaptığı işlemler klinik API’sinde görünmez.

Log nesnesi

Alan	Tür	Açıklama
`id`	integer	Log kimliği
`tenant_id`	integer	Klinik kimliği
`log_name`	string veya null	Log grubu adı
`description`	string	Serbest metin. Model olaylarında genellikle olay adıdır
`subject_type`	string	Değişen kaydın türü, örneğin `App\Models\Customer`
`subject_id`	integer	Değişen kaydın kimliği
`event`	string veya null	Olay türü (Olaylar)
`causer_type`, `causer_id`	string, integer veya null	İşlemi yapan. İkisi de `null` ise işlemi sistem yapmıştır
`causer_name`	string veya null	İşlemi yapan kullanıcının adı. Sistem, silinmiş kullanıcı veya adı boş kullanıcı için `null`
`properties`	nesne veya null	`{ "attributes": {yeni değerler}, "old": {eski değerler} }` ve olaya özgü ek alanlar
`batch_uuid`	string veya null	Birlikte silinen kayıtları gruplayan kimlik
`created_at`, `updated_at`	tarih-saat	Klinik saat diliminde, örneğin `2026-10-12T14:30:00+03:00`

properties içinde updated olaylarında yalnızca değişen alanlar, created olaylarında tüm alanlar yer alır. Hiçbir alanı değiştirmeyen bir güncelleme log üretmez. Parola, iki adımlı doğrulama sırları ve token’lar gibi hassas alanlar loglara yazılmaz.

Olaylar

event alanı aşağıdaki değerleri alabilir. Listeleri yalnızca ilk üçüne göre süzebilirsiniz; diğer değerler yanıtlarda görünür ama event parametresi olarak gönderilirse 422 döner.

`event`	Anlamı	Süzülebilir
`created`	Oluşturuldu	Evet
`updated`	Güncellendi	Evet
`deleted`	Silindi	Evet
`restored`	Geri Yüklendi	Hayır
`merged`	Birleştirildi (hasta birleştirme, hedef hastada)	Hayır
`tag_attached`, `tag_detached`	Etiket Eklendi, Etiket Çıkarıldı	Hayır
`treatment_attached`, `treatment_detached`	Tedavi Eklendi, Tedavi Çıkarıldı (doktor veya asistan kaydında)	Hayır
`erasure_link_copied`	Silme Onay Bağlantısı Kopyalandı	Hayır

Rol ve izin değişiklikleri event: "updated" olarak gelir; ayrım description alanındadır (role_attached, role_detached, permission_attached, permission_detached).

Listeleme

GET /activity-logs sayfalanmış bir liste döndürür. Genel kurallar için sayfalama ve filtreleme ve sıralama sayfalarına bakın.

Parametre	Açıklama
`search`	En çok 255 karakter. `description`, `log_name` ve işlemi yapan kullanıcının adında arar. Her sözcük ön ek olarak eşleşir
`per_page`	1 ile 100 arası, varsayılan 15
`page`	1 veya büyük
`sort_by`	`created_at` (varsayılan), `event`, `subject_type`
`sort_order`	`asc` veya `desc` (varsayılan, en yeni önce)
`event`	`created`, `updated` veya `deleted`
`subject_type`	Kayıt türü. Saklanan takma adı (`App\Models\Customer`) veya model sınıf adını kabul eder
`subject_id`	Kayıt kimliği, 1 veya büyük
`related[]`	İlişkili kayıtların aktivitesini de getirir. `subject_type` ve `subject_id` ile birlikte zorunludur
`causer`	`system` (sistem işlemleri) veya pozitif bir kullanıcı kimliği. `0`, `01`, `-1` ve `System` geçersizdir
`created_at_from`, `created_at_to`	Tarih aralığı. Yalnızca tarih (`2026-10-01`) verirseniz klinik saat diliminde günün başı ve sonu kullanılır. `created_at_to`, `created_at_from` değerinden önce olamaz

Bir kaydın geçmişini görmek için subject_type ve subject_id gönderin. related[] ile kaydın ilişkili kayıtlarını da kapsayabilirsiniz. Her related[] değeri, o kayıt türü için izin verilenlerden biri olmalıdır.

`subject_type`	İzin verilen `related[]` değerleri
`App\Models\User`	`appointments`, `assistantAppointments`, `tickets`, `files`
`App\Models\Customer`	`files`, `notes`, `tickets`, `appointments`, `forms`
`App\Models\Treatment`	`appointments`
`App\Models\TreatmentGroup`	`treatments`
`App\Models\Room`	`appointments`
`App\Models\Tag`	`customers`
`App\Models\FormTemplate`	`questions`, `formOptions`

curl -G "https://app.flextell.ai/api/v1/activity-logs" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "subject_type=App\Models\Customer" \
  --data-urlencode "subject_id=123" \
  --data-urlencode "related[]=appointments" \
  --data-urlencode "created_at_from=2026-10-01" \
  --data-urlencode "per_page=25"

{
  "data": [
    {
      "id": 4501,
      "tenant_id": 12,
      "log_name": "default",
      "description": "updated",
      "subject_type": "App\\Models\\Customer",
      "subject_id": 123,
      "event": "updated",
      "causer_type": "App\\Models\\User",
      "causer_id": 7,
      "causer_name": "Ayşe Yılmaz",
      "properties": {
        "attributes": { "first_name": "Ayşe" },
        "old": { "first_name": "Ayse" }
      },
      "batch_uuid": null,
      "created_at": "2026-10-12T14:30:00+03:00",
      "updated_at": "2026-10-12T14:30:00+03:00"
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": null },
  "meta": { "current_page": 1, "per_page": 25, "total": 1, "timezone": "Europe/Istanbul" }
}

Liste yanıtında success anahtarı yoktur; data, links ve meta alanlarını okuyun. GET /activity-logs/{id} ise success: true, data ve meta.timezone döndürür.

Bulunamayan, başka kliniğe ait veya platform yöneticisi tarafından yapılmış bir logu GET /activity-logs/{id} ile istediğinizde hepsi aynı 404 RESOURCE_NOT_FOUND yanıtını alır. Mesaj Aktivite kaydı bulunamadı şeklindedir.

Giriş kayıtları

GET /authentication-logs, kliniğin şu anki tüm üyelerinin oturum açma ve kapatma kayıtlarını listeler; yalnızca sizinkileri değil. Kliniğin üyesi olmayan kullanıcıların kayıtları gelmez. İki klinikte üye olan bir kullanıcının kayıtları her iki kliniğin listesinde de görünür.

Parametre	Açıklama
`search`	En çok 255 karakter. `ip_address` ve `user_agent` içinde arar; `192.168.99` gibi parçalar eşleşir. Kullanıcı adında aramaz
`user_id`	Tek bir kullanıcıya göre süzer. Var olmayan kullanıcı `422` verir; var olan ama kliniğe ait olmayan kullanıcı boş sayfa döndürür
`login_successful`	Yalnızca `1` (başarılı) veya `0` (başarısız). `true` ve `false` kabul edilmez
`cleared_by_user`	`1` veya `0`. Göndermezseniz ikisi birden gelir
`login_at_from`, `login_at_to`	Giriş zamanı aralığı. Tarih kuralları aktivite logları ile aynıdır
`sort_by`	`login_at` (varsayılan), `ip_address`, `login_successful`
`sort_order`	`asc` veya `desc` (varsayılan)
`per_page`, `page`	`per_page` 1 ile 100 arası, varsayılan 15

Boş gönderilen sort_order varsayılan sıralamaya düşer.

Alan	Tür	Açıklama
`id`	integer	Kayıt kimliği
`authenticatable_id`	integer	Kullanıcı kimliği
`authenticatable`	nesne	`{ id, name }` biçiminde kullanıcı
`ip_address`	string veya null	İstemci IP adresi
`user_agent`	string veya null	Tarayıcı veya uygulama bilgisi
`device_name`	string veya null	Cihaz adı, örneğin `Safari on Mac`
`login_successful`	boolean	`false` başarısız denemedir
`login_at`, `logout_at`	tarih-saat veya null	Giriş ve çıkış zamanı
`is_suspicious`, `suspicious_reason`	boolean, string veya null	Şüpheli giriş işareti ve nedeni
`cleared_by_user`	boolean	Kullanıcı kaydı temizlediyse `true`
`location`	nesne veya null	Konum bilgisi. Çoğu kayıtta `null` olabilir

curl

curl -G "https://app.flextell.ai/api/v1/authentication-logs" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "login_successful=0" \
  --data-urlencode "login_at_from=2026-10-01"

Aktivite ve giriş kayıtlarının hataları

Kod	HTTP	Ne zaman
`UNAUTHENTICATED`	401	Token yok veya geçersiz
`FORBIDDEN`	403	Scope veya klinikteki izin eksik
`TENANT_HEADER_REQUIRED`	400	`X-Tenant` başlığı yok
`TENANT_NOT_FOUND`	404	Klinik bulunamadı veya üyesi değilsiniz
`RESOURCE_NOT_FOUND`	404	`GET /activity-logs/{id}` için kayıt yok
`VALIDATION_FAILED`	422	Parametre kuralı ihlali (alan hataları `errors` altında)
`TOO_MANY_REQUESTS`	429	İstek sınırı aşıldı

Hata yapısı için hata kodları sayfasına bakın.

Geri dönüşüm kutusu

Bir kayıt silindiğinde hemen yok olmaz; çoğu hasta ile ilgili kayıt geri dönüşüm kutusuna girer ve varsayılan olarak 30 gün saklanır. Süre dolunca kayıt kendiliğinden kalıcı olarak silinir. Silme akışının genel anlatımı için silme yaşam döngüsü sayfasına bakın. GET /recycle-bin yalnızca açık (geri yüklenmemiş, kalıcı silinmemiş) ve birlikte silinen kayıtların kökü olan girişleri listeler. Örneğin bir hastayı sildiğinizde, onunla birlikte silinen randevular ayrı satır olmaz; hastanın girişinde relation_summary içinde sayılır.

Geri dönüştürülebilen kayıtlar

Yalnızca aşağıdaki 12 tür geri dönüşüm kutusuna girer. model_name alanı Türkçe etiketi verir.

`model_name`	Kayıt
`Hasta`	Hasta
`Hasta Kimlik Bilgisi`	Hastanın iletişim kimliği
`Hasta Formu`	Hastaya gönderilen form
`Aday (Lead)`	Lead
`Not`	Not
`Dosya`	Dosya
`Kanal Beyaz Listesi`	Kanal izin listesi kaydı
`Randevu`	Randevu
`Satış`	Satış
`Teklif`	Teklif
`Sohbet`	Sohbet
`Destek Talebi`	Destek Talebi

Kullanıcı, doktor, asistan, tedavi, oda, ürün, kategori, marka, etiket, meslek, banka hesabı, OAuth uygulaması, AI rapor ve planı ile agent prompt kayıtları geri dönüşüm kutusuna girmez. Bunları silerseniz API ile geri getiremezsiniz. Silinen dosyaların içeriğinin geri yüklemeyle birlikte geri geleceğine de güvenmeyin; silmeden önce dosyanın bir kopyasını saklayın.

Liste ve giriş nesnesi

Parametre	Açıklama
`model_type`	Yalnızca bu türdeki girişleri getirir. Değer, listede dönen `model_type` değeriyle aynı olmalıdır
`deleted_at_from`, `deleted_at_to`	Silinme zamanı aralığı
`sort_by`	`deleted_at` (varsayılan), `model_type`, `purge_at`
`sort_order`	`asc` veya `desc` (varsayılan)
`per_page`, `page`	`per_page` 1 ile 100 arası

Alan	Tür	Açıklama
`id`	integer	Giriş kimliği. Geri yükleme ve kalıcı silmede bu kimliği kullanırsınız, kaydın kimliğini değil
`tenant_id`	integer	Klinik kimliği
`model_type`	string	Kayıt türü, örneğin `Modules\Customer\Models\Customer`
`model_name`	string	Türkçe tür etiketi, örneğin `Hasta`
`model_id`	integer	Silinen kaydın kimliği
`label`	string	Silindiği andaki görünen ad (en çok 180 karakter)
`deleted_by`	nesne veya null	Silen kullanıcı. `null` ise silmeyi sistem yapmıştır
`deleted_at`	tarih-saat	Silinme zamanı
`purge_at`	tarih-saat	Kaydın kendiliğinden kalıcı silineceği zaman (panelde Otomatik Silinme)
`restored_at`, `purged_at`	tarih-saat veya null	Giriş geri yüklendiyse veya kalıcı silindiyse dolar
`relation_summary`	dizi	Birlikte silinen kayıtların özeti: `[{ relation, label, count }]`. Yoksa `[]`
`related_record_count`	integer	`relation_summary` içindeki sayıların toplamı
`is_recoverable`	boolean	Kaydın satırı hâlâ duruyorsa `true`

curl

curl -G "https://app.flextell.ai/api/v1/recycle-bin" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "sort_by=purge_at" \
  --data-urlencode "sort_order=asc"

Kurulum sihirbazı tamamlanmamış bir klinikte geri dönüşüm kutusu endpoint’leri 428 SETUP_REQUIRED döndürür. Ayrıntı için erişim kilitleri sayfasına bakın.

Geri yükleme ve kalıcı silme

Her ikisi de listedeki giriş id değeri ile çalışır ve istek gövdesi gerektirmez. Yanıt, güncellenmiş giriş nesnesidir; işlemden sonra is_recoverable değeri false olur.

Geri yükleme

POST /recycle-bin/{id}/restore, kaydı ve onunla birlikte silinen tüm ilişkili kayıtları geri getirir. Yanıtta restored_at dolar.

curl

curl -X POST "https://app.flextell.ai/api/v1/recycle-bin/456/restore" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>"

Silinen hastanın telefon numarası bu arada başka bir hastaya verilmiş olabilir. Bu durumda geri yükleme 409 RESTORE_CONFLICT ile reddedilir ve data.conflicts çakışmayı açıklar:

{
  "success": false,
  "error_code": "RESTORE_CONFLICT",
  "message": "Silinen kayıt aktif bir kayıtla çakışıyor.",
  "data": {
    "conflicts": [
      { "model_type": "Customer", "columns": ["tenant_id", "phone_number"], "conflicting_id": 123 }
    ]
  }
}

Çakışan değerin kendisi yanıtta yer almaz. Panel bu durumda

Bu kaydın :fields bilgisi bu arada başka bir kayda verilmiş. Geri yüklemek yerine iki kaydı birleştirmeniz gerekiyor.

mesajını gösterir. Entegrasyonunuz da aynı yönlendirmeyi yapmalıdır: kullanıcıya iki kaydı birleştirmesini önerin.

Kalıcı silme

DELETE /recycle-bin/{id}/purge, kaydı ve birlikte silinen tüm ilişkili kayıtları kalıcı olarak siler. Yanıtta purged_at dolar.

Kalıcı silme geri alınamaz. Süresi dolmamış bir kaydı yalnızca kullanıcı açıkça onayladığında silin.

curl

curl -X DELETE "https://app.flextell.ai/api/v1/recycle-bin/456/purge" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>"

Kaydın satırı daha önce yok olduysa kalıcı silme yine 200 döner ve girişi kapatır.

Hata kodları

Kod	HTTP	Ne zaman
`RESOURCE_NOT_FOUND`	404	Giriş yok, başka kliniğe ait veya (kalıcı silmede) kayıt bu arada geri yüklenmiş. Mesaj `Geri dönüşüm kutusu kaydı bulunamadı`
`RECYCLE_BIN_ENTRY_UNRECOVERABLE`	409	Kayıt artık geri yüklenemez; yalnızca kalıcı silinebilir. Mesaj `Silinen kayıt artık geri yüklenemez.`
`RESTORE_CONFLICT`	409	Benzersiz bir değer (örneğin hasta telefon numarası) başka bir aktif kayda verilmiş
`RECYCLE_BIN_RESTORE_FAILED`	500	Geri yükleme sırasında beklenmeyen hata. Mesaj `Silinen kayıt geri yüklenemedi.`
`RECYCLE_BIN_PURGE_FAILED`	500	Kalıcı silme sırasında beklenmeyen hata. Mesaj `Silinen kayıt kalıcı olarak silinemedi.`

Ortak hatalar (401, 403, 400, 422, 428) için hata kodları sayfasına bakın.

Geri dönüşüm kutusu, KVKK kapsamındaki veri imha talepleri ile aynı şey değildir. İmha talebi kayıtları kutuya almaz; kişisel verileri geri alınamaz biçimde maskeler.

Başlarken

Kimlik Doğrulama

Çok Kiracılılık

İstek Kuralları

Kaynak Rehberleri

Gerçek Zamanlı

Webhook'lar ve Açık Uçlar

Entegrasyonlar

Rehberler

Kaynaklar

Aktivite logları, giriş kayıtları ve geri dönüşüm kutusu

Endpoint özeti

Aktivite logları

Log nesnesi

Olaylar

Listeleme

Giriş kayıtları

Aktivite ve giriş kayıtlarının hataları

Geri dönüşüm kutusu

Geri dönüştürülebilen kayıtlar

Liste ve giriş nesnesi

Geri yükleme ve kalıcı silme

Geri yükleme

Kalıcı silme

Hata kodları

​Endpoint özeti

​Aktivite logları

​Log nesnesi

​Olaylar

​Listeleme

​Giriş kayıtları

​Aktivite ve giriş kayıtlarının hataları

​Geri dönüşüm kutusu

​Geri dönüştürülebilen kayıtlar

​Liste ve giriş nesnesi

​Geri yükleme ve kalıcı silme

​Geri yükleme

​Kalıcı silme

​Hata kodları

Endpoint özeti

Aktivite logları

Log nesnesi

Olaylar

Listeleme

Giriş kayıtları

Aktivite ve giriş kayıtlarının hataları

Geri dönüşüm kutusu

Geri dönüştürülebilen kayıtlar

Liste ve giriş nesnesi

Geri yükleme ve kalıcı silme

Geri yükleme

Kalıcı silme

Hata kodları