Filtreleme, Sıralama, Arama

Flextell’in tüm liste uçları benzer bir sorgu parametresi dilini paylaşır. Kaynaklara özgü ekstra filtreler olsa da, aşağıdaki parametreler tüm liste uçlarında geçerlidir.

Ortak parametreler

string

Serbest metin araması. Kaynağa göre farklı alanlarda (isim, telefon, başlık, vb.) tam-metin araması yapar.

string

Sıralama yapılacak alan. İzin verilen değerler kaynağa göre değişir; aşağıdaki tabloya bakın.

enum

default:"desc"

Sıralama yönü: asc veya desc.

boolean

default:"false"

true gönderirseniz soft-delete edilmiş kayıtlar da yanıta dâhil olur. Soft-delete destekleyen kaynaklarda kullanılabilir.

Kaynaklara özgü filtreler

Her liste uç’unun desteklediği filtreleri API Referansı’ndan doğrulayın. İşte en sık kullanılanların bir özeti:

`GET /v1/customers`

Parametre	Tür	Açıklama
`search`	string	Ad, soyad, telefon, e-posta içinde arama
`sort_by`	enum	`first_name`, `last_name`, `date_of_birth`, `gender`, `created_at`, `updated_at`
`gender`	enum	`male`, `female`, `other`
`min_age`	integer	Minimum yaş
`max_age`	integer	Maksimum yaş
`user_id`	integer	Kayıtlı olduğu personel

`GET /v1/appointments`

Parametre	Tür	Açıklama
`search`	string	Hasta adı, doktor adı, tedavi başlığı içinde arama
`sort_by`	enum	`starts_at`, `ends_at`, `created_at`, `updated_at`
`from`	date-time	`starts_at >= from`
`to`	date-time	`starts_at <= to`
`doctor_id`	integer	Belirli bir doktora filtrele
`customer_id`	integer	Belirli bir hastaya filtrele
`status`	enum	Randevu durumu

`GET /v1/conversations`

Parametre	Tür	Açıklama
`search`	string	Hasta adı, son mesaj içeriği
`channel_type`	enum	`whatsapp`, `telegram`

Tüm uç’ların tam parametre listesi için API Referansı sekmesine bakın. Şema ve örnekler her endpoint için otomatik üretilir.

Örnek: karmaşık bir sorgu

Bu ay yaratılmış, kadın ve 30-40 yaş arası hastaları created_at’e göre azalan sırada listeleyin:

curl --request GET \
  --get "https://dev.flextell.ai/api/v1/customers" \
  --header "Authorization: Bearer $TOKEN" \
  --header "X-Tenant: 12" \
  --data-urlencode "gender=female" \
  --data-urlencode "min_age=30" \
  --data-urlencode "max_age=40" \
  --data-urlencode "sort_by=created_at" \
  --data-urlencode "sort_order=desc" \
  --data-urlencode "per_page=50"

Tarih formatı

Tarih-saat parametreleri ISO 8601 biçiminde beklenir. Mümkünse UTC offset’i ekleyin:

2026-04-19T09:00:00+03:00

Sadece tarih alanları için: 2026-04-19.

Sıralama kuralı

sort_by için desteklenmeyen bir alan gönderirseniz 422 Unprocessable Entity alırsınız.
sort_order yalnızca asc veya desc değerlerini kabul eder.
Varsayılan sıralama genellikle created_at desc’tir; her uçtaki ayar için referansa bakın.

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

Filtreleme, Sıralama, Arama

Ortak parametreler

Kaynaklara özgü filtreler

`GET /v1/customers`

`GET /v1/appointments`

`GET /v1/conversations`

Örnek: karmaşık bir sorgu

Tarih formatı

Sıralama kuralı

​Ortak parametreler

​Kaynaklara özgü filtreler

​GET /v1/customers

​GET /v1/appointments

​GET /v1/conversations

​Örnek: karmaşık bir sorgu

​Tarih formatı

​Sıralama kuralı

Ortak parametreler

Kaynaklara özgü filtreler

`GET /v1/customers`

`GET /v1/appointments`

`GET /v1/conversations`

Örnek: karmaşık bir sorgu

Tarih formatı

Sıralama kuralı