Vahşi doğada API arızaları: zaman aşımları, 429 ve bozuk JSON
Güncelleme
Her operatörün tanıştığı üç API arıza şekli: yavaş yanıtlar, hız limitleri ve bozuk gövdeler, her birinin kendi yanıtı var.
API'ler üç şekilde kırılır, her biri ayrı tembelliği cezalandırır. Zaman aşımları bütçesizliği, 429'lar kör tekrarı, bozuk gövdeler durum koduna güveni cezalandırır. Üç yanıtı bir kez öğren, her entegrasyon sakinleşir.
Bütçe, bekleme, doğrulama
Zaman aşımları bütçe alır. Her dış çağrı arayanın karşılayabildiği son tarih taşır. Zaman aşımı donmayı ele alınır, tekrarlanır ya da raporlanır hataya çevirir.
429'lar dalgalı bekleme alır. Sunucu yavaşlık ister; yanıt üstel bekleme artı rastgeleliktir, filo aynı anda tekrarlamaz. Toplam tekrarı kapa: döngü değil bütçe.
Gövdeler doğrulanır. Kullanmadan şekli kontrol et: zorunlu alanlar, tipler, hata zarfları. Suçlu gövdeyi (sırsız) logla ki sonraki arıza dakikalarda teşhis edilsin.
Çalışılmış örnek: kurgusal bir durum sayfası entegrasyonu
Aşağıdaki bağlam kurgusaldır. Kurgusal ParcelWatch monitörü taşıyıcı API'yi zaman aşımsız, anında tekrarlı, kör JSON ayrıştırmayla yoklar. Bir yavaş taşıyıcı akşamı tüm kontroller donar; sonra 429 fırtınası kendini uzatır; sonra değişen alan adı ayrıştırıcıyı gece 2'de kırar.
Yeniden yazım on saniye bütçe, üç denemede kapalı dalgalı bekleme ve hata logunda ham gövdeli şekil doğrulama koyar. Sonraki taşıyıcı olayı: sınırlı hatalar, sakin tekrarlar, değişen alanı adlandıran tek log satırı.
Karar tablosu: API arıza yanıtları
| Sinyal | Yanıt | Asla |
|---|---|---|
| Yavaş yanıt | Zaman aşımı bütçesi, sonra ele al | Sonsuz bekle |
| 429 | Dalgalı bekleme, kapalı | Döngüde sıcak tekrar |
| Yanlış şekilli 200 | Doğrula, gövdeyi logla, uyar | 200 durumuna kör güven |
İlgili okuma
- Uygulamalı: Sahte API Zaman Aşımı, 429 ve Bozuk JSON.
- DevOps Foundations Modül 2 HTTP istemcilerini anlatır.
Net yanıtlar
Sık sorulan sorular
429'da tekrar deneyeyim mi?
Evet, beklemeli ve dalgalı, yalnızca tekrar bütçesi içinde. Hız limitine tam gaz tekrar kendi yasağını uzatır.
Zaman aşımı ne olmalı?
Arayan taraftan bütçe: kullanıcının beklediği süre eksi kendi payın. Zaman aşımsızlık tek yavaş bağımlılığın her şeyi dondurmasıdır.
JSON yanıtları doğrulanır mı?
Evet, sınırda. Beklenmedik şekilli 200, temiz 500'den çok kod kırar.