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
qdeğerleri çalışır:tr-TR,tr;q=0.9,en;q=0.8Türkçe,en-USİngilizce sonuç verir. - Sunucudan sunucuya çağrılar,
curlve Postman gibi araçlarAccept-Languagegöndermezse Türkçe yanıt alır. İngilizce istiyorsanızAccept-Language: engönderin.
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.
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.