> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Sürümleme ve değişiklik politikası
> API sürümlemesini, geriye dönük uyumluluğu ve değişikliklerin nasıl duyurulduğunu anlatır.
Flextell REST API'si tek bir sürüm sunar: `v1`. Bu sayfa sürüm önekinin ne anlama geldiğini, uyumsuz değişikliklerin nasıl yayımlandığını ve entegrasyonunuzu bozabilecek değişiklikleri nasıl takip edeceğinizi anlatır.
## Sürüm öneki
Tüm REST endpoint'leri `/api/v1` altındadır.
```text theme={null}
https://app.flextell.ai/api/v1/appointments
```
`v2` yoktur. Sürüm öneki, API'nin kalıcı olarak dondurulduğu anlamına gelmez; uyumsuz değişiklikler de `v1` içinde yayımlanır (sonraki bölüme bakın).
Sürüm öneki geriye dönük uyumluluk güvencesi vermez. Entegrasyonunuzu `v1` değişmeyecek varsayımıyla yazmayın; değişiklikleri düzenli takip edin.
### Sürüm öneki taşımayan adresler
Aşağıdaki adresler `/api/v1` altında değildir ve ayrı bir sürüm numarası taşımaz.
| Adres | Kullanım |
| - | - |
| `/api/broadcasting/auth` | Gerçek zamanlı kanallara abonelik yetkisi. Bkz. [Gerçek zamanlı genel bakış](/api/gercek-zamanli/genel-bakis). |
| `/widget/{token}/*` | Web sitesi widget'ı. Bkz. [Web sitesi widget'ı](/api/webhooklar/web-sitesi-widgeti). |
| `/webhook/*` | WhatsApp ve Telegram kanallarından gelen webhook çağrıları. |
| `/veri-imha/{token}` ve `/veri-imha/{token}/onayla` | Hastanın veri imha talebini onayladığı sayfa. |
### OpenAPI belgesindeki sürüm numarası
OpenAPI belgesinin `info.version` alanı `0.0.1` değerini taşır ve sürümlerle birlikte artmaz. Değişiklikleri bu alana bakarak izlemeyin; [Değişiklikleri takip etme](#değişiklikleri-takip-etme) bölümündeki sayfaları kullanın.
## Uyumlu ve uyumsuz değişiklikler
Flextell, sürüm numarasını artırmadan hem eklemeler hem de uyumsuz değişiklikler yayımlar. Hangi durumda ne beklemeniz gerektiği aşağıdaki tabloda özetlenmiştir.
| Değişiklik türü | Örnek | Entegrasyonunuz için anlamı |
| - | - | - |
| Yeni endpoint | Randevu iptali için `POST /appointments/{id}/cancel` | Mevcut çağrılarınız etkilenmez. |
| Yeni sıralama anahtarı veya parametre | `GET /appointments` için `sort_by=upcoming` | Mevcut çağrılarınız etkilenmez. |
| Yeni hata kodu | `CONVERSATION_NOT_ASSIGNED`, `APPOINTMENT_ALREADY_CANCELLED` | Bilinmeyen bir `error_code` için genel bir yedek davranışınız olsun. |
| Yeni izin zorunluluğu | `Cancel:Appointment`, `RevertCancel:Appointment` | Daha önce çalışan çağrı `403` alabilir. Uyumsuz sayılır. |
| Zorunlu başlık | `/oauth/*` ve `/announcements` için `X-Tenant` | Başlığı göndermeyen çağrı `400 TENANT_HEADER_REQUIRED` alır. Uyumsuz sayılır. |
| Yanıt biçimi değişikliği | Tek hata zarfı `{success, error_code, message, errors?, data?}` | İstemci kodunu güncellemeniz gerekir. Uyumsuz sayılır. |
| Kaldırılan endpoint veya filtre | Kayıt başına geri yükleme ve kalıcı silme endpoint'leri, `trashed` filtresi | Çağrı artık çalışmaz. Uyumsuz sayılır. |
Yanıtlarda tanımadığınız alanları yok sayın ve hata işlemede `error_code` değerine göre dallanın. Böylece eklemeler entegrasyonunuzu bozmaz. Hata zarfı için [Hatalar](/api/istekler/hatalar) sayfasına bakın.
### Yeniden adlandırılan parametreler
Daha önce yayımlanmış bir parametre yeniden adlandırıldığında eski ad **takma ad olarak korunmaz**. Yeni ad geçerli olur; eski adı gönderen istek artık aynı sonucu vermez. Tarih filtrelerinde bunun örneği yaşandı: `_from` ve `_to` biçimi tek geçerli ad oldu, `date_from`, `date_to`, `from`, `to` ve `created_from` gibi eski adlar kaldırıldı. Güncel kurallar için [Filtreleme ve sıralama](/api/istekler/filtreleme-ve-siralama) sayfasına bakın.
### Kaldırılan özellikler
Kaldırılan özellikler önce kullanımdan kaldırılmış olarak işaretlenmez; doğrudan kalkar. Silme yaşam döngüsündeki değişiklik buna örnektir: kayıt başına geri yükleme ve kalıcı silme endpoint'leri ile `trashed` filtreleri kaldırıldı, yerine Geri Dönüşüm Kutusu geldi. Bkz. [Silme yaşam döngüsü](/api/istekler/silme-yasam-dongusu).
## Kullanımdan kaldırma
Flextell'de resmî bir kullanımdan kaldırma süresi yoktur. API yanıtları `Deprecation` veya `Sunset` başlığı göndermez; bu başlıklara bakarak uyarı almazsınız.
Tek istisna, yayımlanmış mobil uygulama sürümlerinin kullandığı alanlardır. Bu alanlar silinmez, kullanımdan kaldırılmış olarak belgelenir ve çalışmaya devam eder. Yeni entegrasyonlarda bunların yerine önerilen alanı kullanın.
| Kullanımdan kaldırılan | Yerine kullanın | Not |
| - | - | - |
| Randevu isteğinde `assistant_id` | `assistant_ids` | `POST /appointments` ve `PUT /appointments/{id}` isteklerinde geçerlidir. |
| Hızlı yanıt yanıtındaki `file` alanı | `files` | Eski mobil sürümler için korunur. |
| Birden çok ek içeren hızlı yanıtı `file_id` olmadan gönderme | `file_id` ile gönderin | Eski albüm davranışıdır. |
Bu tablo kullanımdan kaldırılan her şeyi kapsamayı amaçlamaz; yalnızca korunan ve belgelenen alanları listeler. Bir değişikliğin kaldırma mı, yeniden adlandırma mı olduğunu [API değişiklikleri](/surum-notlari/api-degisiklikleri) sayfasından kontrol edin.
## Değişiklikleri takip etme
Entegrasyonunuzu bozabilecek değişiklikler için iki sayfayı izleyin.
Yeni izin zorunlulukları, yeniden adlandırmalar, değişen yanıtlar ve kaldırılan endpoint'ler. Tarih sırasıyla listelenir.
Yeni ve geriye uyumlu eklemeler.
Önerilen çalışma biçimi:
[API değişiklikleri](/surum-notlari/api-degisiklikleri) sayfasını, entegrasyonunuzu güncellemeden önce ve düzenli aralıklarla okuyun. Kayıtlar yeniden eskiye sıralıdır.
Hata işlemenizi HTTP metnine değil `error_code` değerine bağlayın. Güncel liste için [Hata kodları](/api/istekler/hata-kodlari) sayfasına bakın.
Bir değişiklik yeni bir izin ya da başlık istiyorsa, entegrasyonu kullanan kullanıcının rolünü ve istek başlıklarını kontrol edin. Başlıklar için [İstek başlıkları](/api/istekler/basliklar) sayfasına bakın.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.