Skip to main content
Bu sayfa, https://app.flextell.ai/api/v1 altındaki isteklerde hangi başlıkları göndermeniz gerektiğini, yanıtların hangi dilde döneceğini ve saat diliminin nasıl bildirildiğini anlatır. Tarayıcıdan (başka bir alan adından) istek yapan uygulamalar için CORS kuralları da burada.

Zorunlu başlıklar

X-Tenant değerini GET /api/v1/account/tenants yanıtından alırsınız. Başlığın ayrıntıları ve klinik seçimi için Klinikler ve X-Tenant sayfasına bakın. /oauth/clients* ve GET /oauth/scopes endpoint’leri de X-Tenant ister; izin yalnızca o klinikte kontrol edilir.

İsteğe bağlı başlıklar

Yanıt dili

API, hata mesajlarını ve kaynak mesajlarını Accept-Language başlığına göre tr veya en olarak döndürür.
  • Başlık yoksa ya da boşsa yanıt Türkçe döner.
  • Desteklenmeyen bir dil (örneğin fr-FR) yine Türkçe ile sonuçlanır.
  • Bölge etiketleri ve q değerleri çalışır: tr-TR,tr;q=0.9,en;q=0.8 Türkçe, en-US İngilizce sonuç verir.
  • Sunucudan sunucuya çağrılar, curl ve Postman gibi araçlar Accept-Language göndermezse Türkçe yanıt alır. İngilizce istiyorsanız Accept-Language: en gönderin.
Yerelleştirilen metinler: varsayılan hata mesajları, kaynak mesajları, doğrulama (validation) mesajları ve silme ilişkisi etiketleri.
Kodunuzda hata durumunu message metnine göre ayırmayın. Mesaj dile ve zamanla değişebilir; error_code alanına göre dallanın. Hata yapısı için Hatalar sayfasına bakın.
Aşağıdaki metinler Accept-Language değerinden bağımsız olarak her zaman İngilizce gelir:
  • Yönlendirme düzeyindeki hatalar (örneğin olmayan bir adres).
  • Yetkilendirme sunucusunun Invalid scope(s) provided. yanıtı.
  • Adlandırılmış oran sınırlayıcıların mesajları (örneğin Too many requests.). Oran sınırları için Oran sınırları sayfasına bakın.
Kuyrukta oluşturulan dışa aktarmalar ve bunların bildirimleri, isteği yapanın başlığına değil kliniğin dil ayarına göre hazırlanır.

Saat dilimi başlığı

Saat dilimi için gönderdiğiniz bir istek başlığı yoktur. Klinik bağlamındaki her yanıt, kliniğin saat dilimini bildirir: X-Timezone, hata yanıtlarında ve dosya indirmelerinde de bulunur. Anlık zaman alanları bu saat diliminde, açık bir ofsetle yazılır: 2026-03-01T12:00:00+03:00.
Klinik bağlamı olmayan endpoint’lerde (/v1/account/*, /v1/general/*, herkese açık formlar) X-Timezone ve meta.timezone yoktur. Bu endpoint’lerde anlık zamanlar UTC olarak, 2026-06-03T09:00:00.000000Z biçiminde döner. Tarih ve saat kuralları için Veri biçimleri sayfasına bakın.

CORS

Tarayıcıdan istek yapıyorsanız CORS kuralları geçerlidir. Sunucu tarafı uygulamalar (backend, curl, Postman) CORS’tan etkilenmez.
Başka bir origin’deki tarayıcı kodu X-Timezone, X-RateLimit-Limit, X-RateLimit-Remaining ve Retry-After başlıklarını okuyamaz. Saat dilimi için JSON gövdesindeki meta.timezone alanını kullanın. Tarayıcıdan çağırdığınız bir endpoint’te bu başlıklara bağlı bir mantık kurmayın.
Origin’iniz izin listesinde değilse tarayıcı isteği CORS hatasıyla engeller. Hangi origin’lerin tanımlı olduğunu öğrenmek veya origin’inizin eklenmesini istemek için Destek sayfasındaki yollarla iletişime geçin. Ortamlar için Ortamlar sayfasına bakın.
Web sitesi widget’ı kendi CORS kurallarına sahiptir: GET, POST ve OPTIONS metotları, Content-Type, Accept, X-Widget-Token, Origin ve X-Requested-With başlıkları, 3600 saniyelik preflight önbelleği. Ayrıntılar için Web sitesi widget’ı sayfasına bakın.

Örnek istek

Aşağıdaki istek, kliniğin randevu listesini İngilizce mesajlarla ister.
Yanıtta, sunucu tarafında şu başlık bulunur: