API sürümü ve değişiklikler

API sözleşmesini uygulama sürümünden ayırın ve değişiklik kayıtlarını izleyin.

Son güncelleme: 2026-11-10

API sürümü ile uygulama sürümü

Dış entegrasyon sözleşmesi /api/v1 altında sunulur. Yanıttaki X-GIS-API-Surum: 1 bu sözleşmenin sürümünü belirtir. X-GIS-Surum ise yanıtı veren uygulamanın sürümüdür; API sürümüyle aynı değer olmak zorunda değildir. Kurulumunuzdaki gerçek değeri yanıt başlığından okuyun.

Kamuya açık sürüm notları tarih adıyla tutulur. 2026.11 / Kasım 2026 sayfa adlandırması, uygulama başlığının mutlaka 2026.11 döndüğü iddiası değildir. Başlık değerini entegrasyon günlüklerinde hassas bilgi içermeden tutmak, bir davranışı hangi uygulama sürümüyle gözlediğinizi belirlemeye yardımcı olur.

Alan adlarının kararlılığı

Türkçe API alan adları kalıcıdır; alan adları sürüm boyunca değişmez. kod, alan, kapsam veya gizli gibi alanları kendi çevirinizle isteğe yazmayın. Uygulama ekranındaki başlık ile JSON anahtarı farklı olabilir; istek ve yanıt için alan sözlüğünü ve ilgili uç şemasını esas alın.

İstemci, tanımadığı ek yanıt alanlarını görmezden gelebilmeli; eksik zorunlu alan veya değişmiş türü ise hata olarak ele almalıdır. Bir hata açıklamasının metnine göre iş mantığı kurmak yerine HTTP durumu ve varsa kod kullanın.

Değişiklikleri değerlendirme

Yeni bir isteğe bağlı alanın veya yeni bir ucun eklenmesi mevcut kullanımın sürdürülmesine olanak verebilir. Alanın kaldırılması, adının ya da türünün değişmesi veya mevcut anlamın değiştirilmesi entegrasyon açısından uyumsuz değişikliktir. Yeni bir yanıt alanını okumaya başlamadan önce kurulumunuzun şemasıyla mevcut belgeyi karşılaştırın.

Burada kullanımdan kaldırma için sayısal bildirim süresi veya gelecekteki sürüm tarihi taahhüt edilmez. Kuruma özgü güncelleme koşulları ilgili sözleşmede ele alınır. Çerezli /api uçları tarayıcı uygulamasının sözleşmesidir; v1 ile aynı sürüm güvencesini varsaymayın.

Belge değişiklik günlüğü

Bu tablo belge düzenlemesinin kaydıdır; üründe o tarihte yeni bir uç yayınlandığı veya canlı kabulün yapıldığı anlamına gelmez. Kurulum şemasını GET /api/v1/openapi.json ile okuyabilirsiniz. Siteye ait indirilebilir v1 şeması, siteyle birlikte tutulan şema kopyasıdır.