[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"guide-how-to-depend-on-an-api-you-do-not-control::tr":3,"guide-related-how-to-depend-on-an-api-you-do-not-control::tr":17},{"slug":4,"title":5,"excerpt":6,"body":7,"meta_title":5,"meta_description":8,"keywords":9,"category":15,"published_at":16,"updated_at":16},"how-to-depend-on-an-api-you-do-not-control","Kontrolünüzde Olmayan Bir API'ye Nasıl Bağımlı Olunur?","Bir entegrasyonun öteki yarısı başkasının ürünüdür; kendi takvimine göre değişir, süresi dolar ve çöker. Veriyi bozmak yerine geri çekilen ve sorunu müşterinizden önce fark eden bir bağlayıcı nasıl kurulur.","\u003Ch2>Ekibinizden kimsenin sahibi olmadığı yarı\u003C\u002Fh2>\n\u003Cp>Bir entegrasyonun iki yarısı vardır ve siz yalnızca birini yazarsınız. Diğeri, kendi yol haritası, kendi kesintileri ve kırıcı değişikliğin ne olduğuna dair kendi tanımı olan, size danışmak zorunda olmayan bir üründür. Emeğin çoğu sizin kontrol ettiğiniz yarıya gider; arızaların çoğu kontrol etmediğiniz yarıdan gelir.\u003C\u002Fp>\n\u003Cp>Konu bir model sağlayıcısını bir başkasıyla değiştirmek değil; onun bilinen bir cevabı var: sağlayıcıyı tek bir kapının arkasına koyun. Konu, bir ürünün bağlandığı sıradan sistemler — CRM, destek masası, faturalama — yani bağımlılığı soyutlayıp geçemeyeceğiniz yerler, çünkü bütün mesele tam da o sistemdir.\u003C\u002Fp>\n\u003Ch2>Hoşgörüyle okuyun, titizlikle yazın\u003C\u002Fh2>\n\u003Cp>Bir entegrasyonun bozulmasının en yaygın yolu, karşı tarafın bir şey eklemesidir. Tanımadığı alanları reddedecek biçimde ayarlanmış bir ayrıştırıcı, yukarıdaki sıradan her eklemeyi sizin tarafınızda bir kesintiye çevirir; üstelik sağlayıcı yanlış bir şey yapmamıştır. Kullandığınız alanları okuyun, gerisini görmezden gelin ve sabit değer listelerini açık uçlu sayın: bir duruma göre dallanan ve tanımadığı her şeyde hata fırlatan kod, yeni bir durum yayımlandığı ilk gün çöker. Tanınmayan kaydı sessizce bir varsayılana eşlemek yerine bir insanın bakması için beklemeye alın; yanlış bir varsayılan çökmekten kötüdür, çünkü olup bittiğini size kimse söylemez.\u003C\u002Fp>\n\u003Cp>Hoşgörünün adı konulması gereken bir bedeli var. Tanımadığı her şeyi geçen bir okuyucu, bilmeniz gereken değişikliği de geçer; o yüzden bilinmeyen alanları ve tanınmayan değerleri kendi günlüklerinize yazın. Çoğu ekip bir sağlayıcının yeni bir şey yayımladığını tam olarak bu günlük satırından öğrenir. Yazmak ise tersi bir disiplindir: yalnızca ayarlamak istediğiniz alanları gönderin, çünkü nesnenin tamamını geri yollamak hiç anlamadığınız kısımların üzerine yazmaktır; ve tekrarın ikinci bir kayda dönüşmemesi için her yazmaya bir tekillik anahtarı iliştirin.\u003C\u002Fp>\n\u003Ch2>Sabitleyebildiğinizi sabitleyin, kendi bağlayıcınızı sürümleyin\u003C\u002Fh2>\n\u003Cp>Sağlayıcı açık API sürümleri sunuyorsa birini seçin ve her çağrıda belirtin; isteklerin güncel olana serbestçe sürüklenmesine izin vermeyin. Sürüklenme, olmadığı sabaha kadar rahattır. Sabitlenecek bir şey yoksa, yerine geçecek yol, o sağlayıcıya giden her çağrıyı kendi kodunuzda tek bir modülün arkasında tutmaktır: şekil değiştiğinde değiştirilecek tek bir yer ve neye bağımlı olduğunuzu görmek için okunacak tek bir yer.\u003C\u002Fp>\n\u003Cp>O modüle kendi sürüm numarasını verin ve yazdığınız her kaydın hangi sürümle işlendiğini kaydedin. Üç hafta sonra soru daima \"bunu hangi kod üretti\" olur; cevap veremeyen bir entegrasyon küçük bir düzeltmeyi kazı çalışmasına çevirir. Aynı kayıt kademeli çıkışa da izin verir — tek bir müşteri, tek bir kuyruk, trafiğin yüzde biri — herkesin sorunu hâline gelmeden önce.\u003C\u002Fp>\n\u003Ch2>Kullanımdan kaldırma duyurusunun size ulaşmayacağını varsayın\u003C\u002Fh2>\n\u003Cp>Sağlayıcılar değişiklikleri gerçekten duyurur: kimsenin abone olmadığı bir sürüm notunda, dört yıl önce hesabı açan kişiye giden bir e-postada ve ekibinizin artık açmadığı bir panonun üstündeki şeritte. Sunulan her kanala abone olun, sonra da hiçbiri ulaşmayacakmış gibi kurun.\u003C\u002Fp>\n\u003Cp>Bunun somut karşılığı küçük ve sıkıcı bir kanaryadır: bağımlı olduğunuz her uç noktaya, bilinen bir girdiyle ve yanıtın şekli üzerine bir doğrulamayla yapılan zamanlanmış bir çağrı; cevap değiştiğinde alarm verir. Yazması bir saat sürer ve salı sabahı öğrenmekle müşteriden öğrenmek arasındaki farktır. Yanıtların kendisini de izleyin: pek çok sağlayıcı bir şeyi kapatmadan çok önce başlıkta uyarır. Bildirim süresini de bu ilişkideki en güvenilmez sayı sayın; o süre onların yayımladığı andan işler, sizin fark ettiğiniz andan değil.\u003C\u002Fp>\n\u003Ch2>Onların kesintisi, aksine karar vermedikçe sizin kesintinizdir\u003C\u002Fh2>\n\u003Cp>Durum sayfası, sağlayıcının kendi erişilebilirliğine dair kendi beyanıdır; ondan sorumlu ekip tarafından yayımlanır ve gecikir. Onu zaten taşıdığınız bir şüpheyi doğrulamak için kullanın, size haber veren şey olarak değil; gerçek sinyal o sağlayıcıya karşı kendi hata oranınızdır.\u003C\u002Fp>\n\u003Cp>Karşı taraf erişilemezken ürününüzün ne yapacağı keşfedilmemeli, kararlaştırılmalıdır. Okumalar genellikle bayat olduğunu dürüstçe söyleyen bir işaretle sunulabilir. Yazmalar tehlikeli yarıdır: tekillik anahtarıyla yeniden deneyin, şimdi gidemeyeni kuyruğa alın ve uzun bir kesintinin hizmet döner dönmez izdihama dönüşmemesi için kuyruğa tavan koyun. Tasarımla dışarıda bırakılması gereken arıza yarım kalmış yazmadır: onların tarafında oluşmuş bir kayıt, sizin tarafınıza dönmüş bir hata ve ikisini yeniden bir araya getiren hiçbir şey.\u003C\u002Fp>\n\u003Ch2>Kimlik bilgileri başkasının takvimine göre ölür\u003C\u002Fh2>\n\u003Cp>Üçüncü taraf bir sisteme erişim genellikle size değil müşteriye aittir ve kimse size söylemeden geri çekilebilir: iptal edilen bir belirteç, bir yöneticinin kaldırdığı bir izin, bağlantının kurulduğu hesabın silinmesi. İzinler ayrıca hiç hata vermeden daralır; çünkü bir bağlantının yapabildiği şey, uygulamanızın istediği, müşterinin onayladığı ve o kişinin kendi rolünün izin verdiği kümelerin kesişimidir ve son ikisi size sorulmadan değişir.\u003C\u002Fp>\n\u003Cp>İki alışkanlık bunu yaşanabilir kılar. Kendi kodunuzda boş sonuçla reddi ayırın; \"kayıt bulunamadı\" gibi ele alınan bir izin hatası, entegrasyon sessizce hiçbir şey yapmazken her şey yolunda diyen bir ekran üretir. Ve doğru kişiye söyleyin: boş ekrana bakan kullanıcı iptal edilmiş bir yetkiyi onaramaz, onarabilecek yönetici ise durumdan habersizdir. Yanlış muhataba nazikçe hata veren bir entegrasyon kalıcı olarak bozulmuştur.\u003C\u002Fp>\n\u003Ch2>Kapatıldığı gün için bir planınız olsun\u003C\u002Fh2>\n\u003Cp>Uç noktalar emekliye ayrılır, ücretsiz katmanlar kapanır, ürünler satın alınıp bir başka şeyin içine katlanır ve şartlar sizin kullanımınızı dışarıda bırakacak biçimde değişir. Birkaç yıllık bir ufukta bu, en az bir bağımlılık için neredeyse kesinliktir.\u003C\u002Fp>\n\u003Cp>Hazırlanmak, adını koyamadığınız bir yedek için soyutlama inşa etmek demek değildir. Hangi özelliklerinizin duracağını bilmek, hizmet vermeyi sürdürmek için gerekecek verinin kendi kopyasını tutmak ve belgelenmemiş uç noktalar konusunda kendinize dürüst olmak demektir: kendi tarayıcınızı izleyerek bulduğunuz bir çağrı, çalışmayı bıraktığı ana kadar çalışır ve hiçbir bildirim süresi taşımaz. Her sağlayıcı için neyin bozulacağını ve kime haber verileceğini yazın — bir öğleden sonralık iştir ve bütün bunların içinde duyurudan önce yapılması sonrasından kolay olan tek parçadır.\u003C\u002Fp>","Başkasının API'sine entegrasyon: hoşgörüyle okumak, sürüm sabitlemek, size ulaşmayacak kullanımdan kaldırma duyurusunu beklemek ve iptal edilen erişime hazırlanmak.",[10,11,12,13,14],"api kullanımdan kaldırma","üçüncü taraf api entegrasyonu","hoşgörülü okuyucu","bağlayıcı sürümleme","entegrasyon güvenilirliği","deployment","2026-09-01T03:30:02+00:00",[18,23,27,31,36,41],{"slug":19,"title":20,"excerpt":21,"updated_at":22},"ai-tool-pricing-models-seat-vs-usage-vs-credits","Yapay Zekâ Araçlarında Fiyatlandırma Modelleri: Kullanıcı Başına, Kullanıma Dayalı ve Kredili","Yapay zekâ araçlarının ücret aldığı üç yaygın yöntem — kullanıcı başına, kullanıma göre ve kredili — ve ekibinizin çalışma biçimi için hangisinin gerçekten daha ucuza geleceğini nasıl değerlendireceğiniz.","2026-08-05T14:32:26+00:00",{"slug":24,"title":25,"excerpt":26,"updated_at":22},"how-ai-image-generators-differ-diffusion-vs-the-rest","Yapay Zeka Görsel Üreticileri Arasındaki Farklar: Diffusion ve Diğerleri, Sade Bir Dille","Yapay zeka görsel üreticilerinin nasıl çalıştığına, diffusion yaklaşımının neden baskın hale geldiğine ve araçlar arasında pratikte hangi farkları beklemeniz gerektiğine dair teknik olmayan bir açıklama.",{"slug":28,"title":29,"excerpt":30,"updated_at":22},"how-to-automate-your-workflow-without-code","Kod Yazmadan İş Akışınızı Nasıl Otomatikleştirirsiniz","Ayakta kalan otomasyonlar kurmak için pratik bir sıra: doğru süreci seçmek, bir araca dokunmadan önce haritalamak ve ilk denemelerin çoğunu bozan hata durumlarını ele almak.",{"slug":32,"title":33,"excerpt":34,"updated_at":35},"how-to-build-a-chatbot-without-coding","Kod Yazmadan Chatbot Nasıl Kurulur","Kodsuz araçlarla çalışan bir chatbot'a giden pratik bir yol: kapsama karar vermek, kendi içeriğinizi bağlamak, yanıtlayamadığı soruları ele almak ve maliyetini bilmek.","2026-08-05T14:32:27+00:00",{"slug":37,"title":38,"excerpt":39,"updated_at":40},"how-to-build-an-evaluation-set-that-does-not-go-stale","Bayatlamayan Bir Değerlendirme Kümesi Nasıl Kurulur?","Değerlendirme kümelerinin çoğu bir kez, toplanması kolay olan neyse ondan derlenir ve sonra sessizce işi temsil etmeyi bırakır. Zaten elinizde olan arızalardan bir küme nasıl kurulur, üretimden nasıl beslenir, ölçtüğü sistemden nasıl korunur ve ne zaman süresinin dolduğu nasıl anlaşılır.","2026-09-09T03:30:02+00:00",{"slug":42,"title":43,"excerpt":44,"updated_at":45},"how-to-change-a-prompt-without-breaking-production","Üretimi Bozmadan Bir Prompt Nasıl Değiştirilir","Promptlar bir metin kutusunda düzenlenip saniyeler içinde yayına alınır; sessizce bir şeyleri bozmalarının nedeni budur: derleyici yok, yığın izi yok, bariz bir arıza anı yok. Onlara koddaki sürüm disiplinini verin.","2026-08-24T03:30:02+00:00"]