Skip to main content
Flextell’de bir dosya her zaman bir üst kaynağa (hasta, sohbet mesajı, AI raporu, vs.) bağlıdır. Yükleme iki şekilde yapılabilir:
  1. Doğrudan POST /v1/files — dosyayı bağlı olacağı kaynağın ID’si ile birlikte yükleyin.
  2. Bağlam içinden — örneğin POST /v1/conversations/{id}/messages/media mesajla birlikte medya yüklemek için.

​
Zorunlu header’lar

Multipart isteklerde Content-Type header’ını elle ayarlamayın. HTTP istemciniz (fetch, axios, curl vb.) boundary ile birlikte doğru değeri üretecektir.

​
POST /v1/files — dosya yükleme

​
Parametreler

​
file
required
İkili dosya içeriği. Maksimum boyut 50 MB (51200 KB).
​
enum
required
Dosyanın türü (ör. document, image, report, …). Geçerli değerler için API Referansı’na bakın.
​
enum
required
Dosyanın bağlı olacağı üst kaynak türü. Desteklenenler:
  • customer
  • user
  • tenant
  • chat_log
  • ai_report
​
integer
required
Üst kaynağın ID’si. Örneğin fileable_type=customer için hasta ID’si.
​
string
Dosyaya iliştirilecek açıklama.

​
Örnek istek

​
Yanıt

​
Dosya indirme

Yanıtta gelen download_url kısa ömürlü bir bağlantıdır. Direkt olarak tarayıcı açabilir veya arka uçta şu endpoint’i kullanabilirsiniz:
Bu URL Authorization header’ı gerektirir ve tenant erişim kontrolü yapar. URL’i public paylaşmayın — yetkisiz kullanıcıya sızması HIPAA/KVKK benzeri uyum riskleri doğurur.
Birden fazla dosyayı tek bir group_id ile birleştirmek için GET /files/group/{group_id} kullanabilirsiniz (örn. bir hastaya yüklenen tüm röntgenleri zip olarak indirmek için).

​
Dosya listeleme

Bir üst kaynağa bağlı tüm dosyaları çekmek için:
Desteklenen filtreler: type, fileable_type, fileable_id, trashed.

​
Sohbette medya gönderme

Bir görüşmeye medya eklemek için ayrı bir uç vardır:
Bu uç, dosyayı otomatik olarak chat_log türünden bir kaynağa bağlar ve mesajı hastanın kanalı (WhatsApp/Telegram) üzerinden iletir.

​
Güvenlik ve uyum

  • Dosyalar S3 uyumlu bir depolama üzerinde private olarak tutulur. Direkt link yoktur; tüm indirme istekleri Flextell üzerinden kontrollü şekilde geçer.
  • Dosya içeriği yüklemeden önce virüs taramasına gönderilir (büyük dosyalarda birkaç saniye gecikme olabilir).
  • Hasta verisi içeren dosyalar KVKK/HIPAA uyumlu şekilde saklanır — paylaşımlarınızda bunu hatırda tutun.

​
Sınırlar