[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"glossary-api-versioning::tr":3,"gloss-cluster-api-versioning::tr":26,"gloss-next-api-versioning::tr":9},{"slug":4,"category":5,"name":6,"definition":7,"meta_desc":8,"faq":9,"schema_markup":9,"related":10},"api-versioning","dev-tools","API Versioning","API versioning (API sürümleme), mevcut istemcilerin, API'yi geliştirdiğinizde çalışmaya devam etmesi için bir public API'deki değişiklikleri yönetme pratiğidir. Başkalarının uygulamaları, mobil istemcileri ve entegrasyonları sizin yanıt şekillerinize bağlı olduğu için bir alanı öylece yeniden adlandıramaz ya da bir endpoint'i kaldıramazsınız — bu onları sessizce bozar. Sürümleme, kırıcı değişiklikleri yeni bir sürüm (v1, v2) altında göndermenize, eski sürüm ise hizmet vermeye devam ederken, olanak tanır. Yaygın stratejiler URL tabanlı (\u002Fv1\u002Forders), header tabanlı (Accept: application\u002Fvnd.api+json;version=2) ya da query parametreleridir. Daha geniş disiplin, kırıcı değişiklikleri (bir alanı kaldırmak, bir tipi değiştirmek) geriye dönük uyumlu olanlardan (opsiyonel bir alan eklemek) ayırmak ve sürümü yalnızca ilki için yükseltmektir. Public ya da partner API'si gönderen AI\u002FSaaS ekipleri için sürümleme, net bir kullanımdan kaldırma (deprecation) politikasıyla birlikte, her müşteriyi bozmadan içeride hızlı hareket etmenizi sağlar. Pratik not: yalnızca v1'iniz olsa bile ilk günden sürümleyin ve bir şeyi kaldırmadan çok önce kullanımdan kaldırma takvimlerini duyurun.","API sürümleme, halihazırda çağıran istemcileri bozmadan public bir API'yi geliştirme yöntemidir: URL yolu, header ya da tarihli sürümler artı emeklilik politikası.",null,[11,14,17,20,23],{"slug":12,"name":13},"api","API",{"slug":15,"name":16},"idempotency","Idempotency (Idempotentlik)",{"slug":18,"name":19},"sdk","Yazılım Geliştirme Kiti (SDK)",{"slug":21,"name":22},"semantic-versioning","Anlamsal Versiyonlama (SemVer)",{"slug":24,"name":25},"webhook","Webhook",[27,31,34,38,41,44,47,50,53,56,59,62],{"slug":28,"category":5,"name":29,"updated_at":30},"agent","Ajan (Agent)","2026-08-24T02:46:36+00:00",{"slug":32,"category":5,"name":33,"updated_at":30},"ai-code-assistant","AI Kodlama Asistanı",{"slug":35,"category":5,"name":36,"updated_at":37},"api-gateway","API Ağ Geçidi (API Gateway)","2026-08-24T02:46:37+00:00",{"slug":39,"category":5,"name":40,"updated_at":30},"autonomous-agent","Otonom Ajan (Autonomous Agent)",{"slug":42,"category":5,"name":43,"updated_at":37},"blue-green-deployment","Blue-Green Deployment",{"slug":45,"category":5,"name":46,"updated_at":37},"canary-deployment","Canary Deployment",{"slug":48,"category":5,"name":49,"updated_at":37},"chaos-engineering","Chaos Engineering",{"slug":51,"category":5,"name":52,"updated_at":30},"ci-cd","Sürekli Entegrasyon \u002F Sürekli Dağıtım (CI\u002FCD)",{"slug":54,"category":5,"name":55,"updated_at":37},"circuit-breaker","Devre Kesici (Circuit Breaker)",{"slug":57,"category":5,"name":58,"updated_at":37},"cli","Komut Satırı Arayüzü (CLI)",{"slug":60,"category":5,"name":61,"updated_at":37},"cloud-development-environment","Bulut Geliştirme Ortamı (CDE)",{"slug":63,"category":5,"name":64,"updated_at":30},"code-completion","Kod Tamamlama"]