Skip to main content
Entegrasyon sırasında takıldığınızda önce hata yanıtını okuyun, sonra gerekirse Flextell ekibine sorun bildirin. Bu sayfa, hangi durumda ne yapacağınızı ve bir bildirimde hangi bilgilerin bulunması gerektiğini anlatır.

​
Yardım alma

Çoğu hata, yanıtın kendisinden çözülür. Yanıttaki error_code ve message alanlarına bakın, ardından aşağıdaki tabloda ilgili satıra gidin. Tüm kodların listesi için Hata kodları sayfasına bakın. Ortam adresleri için Ortamlar, başlıklar için Başlıklar sayfasını kullanın.
Yönlendirme (routing) aşamasında oluşan hatalar, örneğin bilinmeyen yol için 404 ya da yanlış metot için 405, İngilizce çerçeve mesajı taşır. Bu mesajlar Accept-Language başlığından etkilenmez. Kodu (RESOURCE_NOT_FOUND, METHOD_NOT_ALLOWED) esas alın.
Bir hata kodu dokümanda yoksa ya da yanıt dokümandaki davranışla uyuşmuyorsa, aşağıdaki bilgilerle Flextell ekibine bildirin.

​
Sorun bildirirken gerekenler

Bildirimde aşağıdaki bilgileri bulundurmak, sorunun tekrar üretilmesini hızlandırır. Tarayıcıdan başka bir kaynaktan (origin) istek atıyorsanız X-Timezone, X-RateLimit-* ve Retry-After başlıklarını JavaScript ile okuyamazsınız. Saat dilimi için yanıttaki meta.timezone alanını kullanın. Örnek bir bildirim metni:
Bildirime access_token, refresh_token, istemci gizli anahtarı (client secret), gelen webhook’un X-Flextell-Secret değeri ya da parola eklemeyin. Gerçek hasta bilgilerini de örnek gövdeden çıkarın. Gerekirse Ayşe Yılmaz ve +90 5xx xxx xx xx gibi örnek değerlerle değiştirin.

​
Bildirimi iletme

Flextell ekibine ulaşmanın kanalı, kliniğin panelindeki Sorun Bildirimlerim menüsüdür. Bildirimi, entegrasyonu kullanan kliniğin panel kullanıcısı oluşturur. Adımlar Sorun bildirimleri sayfasında anlatılır. Yukarıdaki bilgileri Açıklama alanına yazın.
1

Menüyü açın

Sol menünün altındaki Sorun Bildirimlerim öğesine gidin.
2

Yeni bildirim açın

Yeni Sorun Bildirimi düğmesine tıklayın.
3

Formu doldurun

Başlık alanına kısa bir özet (en fazla 255 karakter), Açıklama alanına yukarıdaki bilgileri yazın (en fazla 5000 karakter).
4

Gönderin

Oluştur düğmesine tıklayın. Başarılı olursa Sorun bildirimi oluşturuldu bildirimi ve PSR- ile başlayan talep kodu görünür.
Bildirim oluşturmak için rolünüzde Panel Destek Talepleri grubunda Görüntüle ve Oluştur izinleri bulunmalıdır. Bu izinler yoksa klinik yöneticisi rol düzenleyicisinden ekleyebilir.
Bildirim formunda ekran görüntüsü ya da dosya eki alanı yoktur. Gerekli her şeyi metin olarak Açıklama alanına yazın. Bildirimlerinizi Sorun Bildirimlerim listesinden, Durum sütunundaki Açık, İşleniyor, Çözüldü ve Kapalı değerleriyle izleyebilirsiniz. Listede yalnızca kendi açtığınız bildirimler görünür.
Bu bildirim, hastalarınızın açtığı Destek Talepleri ile aynı şey değildir. Destek Talepleri hasta tarafındaki sohbet kaydıdır (bkz. Destek Talepleri). Sorun Bildirimi ise kliniğin Flextell ekibine ilettiği bildirimdir.

​
API üzerinden bildirim

Sorun bildirimini API ile de oluşturabilirsiniz. Token’da panel_tickets:write scope’u, kullanıcıda ilgili klinikte Create:PanelTicket izni olmalıdır. Bildirimleri listelemek ve okumak için panel_tickets:read scope’u ve View:PanelTicket izni gerekir. Alanlar ve yanıtlar için Sorun bildirimleri sayfasına bakın.
subject zorunludur ve en fazla 255 karakterdir. description zorunludur. Yanıt 201 ile döner ve bildirimin code değerini içerir. İstek idempotent değildir: aynı isteği iki kez gönderirseniz iki bildirim oluşur.

​
API referansı

Endpoint’lerin parametreleri, yanıt şemaları ve hata yanıtları bu sitenin API Referansı sekmesindedir. Bu sekme, Flextell’in OpenAPI belirtiminden otomatik üretilir. Metin açıklamaları ve iş kuralları ise bu sekmedeki kaynak rehberlerinde yer alır.
  • Belirtimi makine tarafından okunur biçimde almak için API sunucusunun /docs/api.json adresini (OpenAPI 3.1), etkileşimli arayüz için /docs/api adresini kullanın. Bu adresler kimlik doğrulaması istemez.
  • Belirtimdeki info.version değeri sürümleri izlemez. Değişiklikler için API değişiklikleri sayfasına bakın.
  • Tüm uç noktalar /api/v1 altındadır. v2 yoktur; kırıcı değişiklikler de v1 içinde yayımlanır. Ayrıntı için Sürümleme sayfasına bakın.

​
Geri bildirim

Hata dışındaki konular için de aynı kanalı kullanabilirsiniz: eksik bir endpoint, belirsiz bir doküman cümlesi, yeni alan ya da iyileştirme önerisi.
  • Doküman geri bildirimi. Hangi sayfanın hangi cümlesinin yanlış ya da eksik olduğunu yazın. Sayfanın yolunu, örneğin /api/destek, bildirime ekleyin.
  • Özellik isteği. Çözmek istediğiniz iş problemini anlatın. Hangi endpoint’in ne döndürmesini beklediğinizi örnek bir istek ve yanıtla gösterin.
  • Hata bildirimi. Yukarıdaki bölümdeki bilgilerle gönderin.
Başlık alanına konuyu tek cümleyle yazın. Panelin önerdiği örnek biçim Randevu ekranında filtre çalışmıyor gibi kısa ve somut bir ifadedir. Açıklama alanına sorunun hangi ekran ya da endpoint’te yaşandığını ve tekrar etme adımlarını yazın. Panelde beklenmeyen bir hata ekranı çıkarsa ekrandaki bize bildir bağlantısı sizi aynı bildirim sayfasına götürür.