Skip to main content
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

​
search
string
Serbest metin araması. Kaynağa göre farklı alanlarda (isim, telefon, başlık, vb.) tam-metin araması yapar.
​
sort_by
string
Sıralama yapılacak alan. İzin verilen değerler kaynağa göre değişir; aşağıdaki tabloya bakın.
​
sort_order
enum
default:"desc"
Sıralama yönü: asc veya desc.
​
trashed
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

ParametreTürAçıklama
searchstringAd, soyad, telefon, e-posta içinde arama
sort_byenumfirst_name, last_name, date_of_birth, gender, created_at, updated_at
genderenummale, female, other
min_ageintegerMinimum yaş
max_ageintegerMaksimum yaş
user_idintegerKayıtlı olduğu personel

​
GET /v1/appointments

ParametreTürAçıklama
searchstringHasta adı, doktor adı, tedavi başlığı içinde arama
sort_byenumstarts_at, ends_at, created_at, updated_at
fromdate-timestarts_at >= from
todate-timestarts_at <= to
doctor_idintegerBelirli bir doktora filtrele
customer_idintegerBelirli bir hastaya filtrele
statusenumRandevu durumu

​
GET /v1/conversations

ParametreTürAçıklama
searchstringHasta adı, son mesaj içeriği
channel_typeenumwhatsapp, 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.