Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Uygulama İş Yükleri için Hız Sınırlarını Optimize Et

API kısıtlamasını yönetin ve uygulamanızda SP-API kullanımını optimize edin.

Satış Ortağı API (SP-API) uygulamanızı tasarlarken, API başına kaynak oranı sınırlarını göz önünde bulundurmalısınız. Satış Ortağı API'si, kullanılabilirliği korumak ve tek tek API'lerin aşırı yüklenmesini önlemek için her satış ortağı için API başına bir kaynak kotası tutar.

Bu oran sınırlarını aşarsanız, SP-API bir değer döndürür 429 Too Many Requests hata yapar ve çağrıyı azaltır. Aşırı API kısıtlaması, iş başarısızlığına, gecikmelere ve operasyonel verimsizliklere neden olabilir ve sonuçta kuruluşunuza zaman ve paraya mal olur. Bu hata yanıtlarını alırsanız, başarısız istekleri ücret sınırlarına uygun bir şekilde yeniden gönderebilirsiniz.

Bu kılavuz, API kısıtlamasını etkin bir şekilde yönetmenize ve SP-API uygulamalarınızın performansını ve güvenilirliğini optimize etmenize yardımcı olacak aşağıdaki stratejileri özetlemektedir:

SP-API entegrasyonunun çeşitli yönleriyle ilgili en iyi uygulamalar hakkında kapsamlı rehberlik için bkz. SP-API Well-Architected Guidance çalma listesi Amazon SP-API Geliştirici Üniversitesi kanalında.

Oran sınırlarını kontrol edin ve bunlara uyun

Fiyat sınırlarının nasıl kontrol edileceğine ve bunlara uyulacağına ilişkin aşağıdaki kılavuzu inceleyin.

Hız limitlerini kontrol edin

Belgelerdeki her SP-API işlemi için kullanım planını gözden geçirin. Kullanım planını nasıl bulacağınızı öğrenmek için bkz. Kullanım planınızı nasıl bulabilirsiniz.

Belgelenen sınırları API yanıtlarının hız sınırı başlıklarıyla karşılaştırın. Yanıt başlığı HTTP durum kodları 20x, 400 ve 404 için kullanılabilir. Kısıtlamayı önlemek için, uygulamanızı bu sınırlar içinde kalacak şekilde tasarlayın.

Kullanım planları ve SP-API hız sınırlama algoritmasının nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz. Kullanım Planları ve Ücret Sınırları.

Bir hata izleme ve uyarı sistemi kurun

API hız sınırlarına uymak için, hatalar meydana geldiğinde izlemek ve uyarmak için etkili bir sistem kurmak çok önemlidir. Bu işlem tipik olarak aşağıdaki adımları içerir:

  1. API yanıtlarını günlüğe kaydedin: Hataların analizini ve sınıflandırılmasını sağlamak için durum kodları, üstbilgiler ve hata mesajları dahil olmak üzere API yanıt verilerinin tamamını yakalayın ve saklayın.
  2. Hataları kategorize edin: Günlüğe kaydedilen hataları HTTP durum kodlarına göre ilgili klasörlerde düzenleyin. Örneğin, 400 düzeyli istemci hatalarını şu kategorilere ayırabilirsiniz: 400 geçersiz giriş, 403 kimlik doğrulama sorunu, 404 kaynak bulunamadı, 429 oran sınırı ihlali vb.
  3. Hata panosu oluşturma: Sorunlu alanları hızlı bir şekilde tanımlamak için her API işlemi ve hata türü için hata oranlarını merkezi bir gösterge tablosunda görselleştirin.
  4. Uyarı eşiklerini ayarlayın: Her hata türü için uygun eşikler tanımlayın ve hata oranları bu eşikleri aştığında sizi proaktif olarak bilgilendirecek uyarılar ayarlayın.

AWS hizmetlerini kullanıyorsanız, bu en iyi uygulamayı şu şekilde uygulayabilirsiniz: Amazon Bulut İzleme:

  • CloudWatch günlükleri: Ayrıntılı API yanıt verilerini yakalayın ve saklayın.
  • CloudWatch metrik filtreleri: Durum kodlarına göre farklı hata türlerini saymak için özel metrikler oluşturun.
  • CloudWatch alarmları: Hata ölçümlerini izleyin ve bildirimleri tetikleyin (örneğin, Amazon Basit Bildirim Hizmeti) eşikler ihlal edildiğinde.

Dikenli trafikten kaçının

Belirli işlemlere yönelik yoğun çağrı patlamalarını ve ardından minimum aktivite dönemlerini önlemek için API isteklerini zaman içinde eşit olarak dağıtın. Bu düzensiz ani artışlar, trafiği zaman içinde yayarak önleyebileceğiniz 429 ek hataya neden olur.

Yüksek hacimli trafiği yönetmek için bir hız sınırlayıcı uygulayabilir ve API başına kaynak sınırlarına göre saniyede N isteğe izin verebilirsiniz. Hız sınırlayıcı, trafik zirvelerini azaltmak ve tek tip API kullanımını teşvik etmek için zaman içinde tutarlı bir çağrı modeli sağlar. Hız sınırlayıcısındaki her API için kılavuz olarak API başına oran sınırını kullanın.

Aşağıdakileri kullanan adım adım kod örneği için Satış Ortağı API Kimlik Doğrulama/Yetkilendirme Kitaplığı bir hız sınırlayıcı uygulamak için aşağıdaki örnek koda bakın.

Yeniden deneme ve geri çekme tekniklerini uygulayın

İş yüklerinizi etkilememek ve uygulamanızın güvenilirliğini artırmak için aşağıdaki teknikleri proaktif olarak uygulayın:

  • Tekrar dene: Otomatik yeniden deneme mantığını uygulayın. İstekleriniz arasında küçük bir gecikme ekleyerek ve sıraya koyarak yeniden deneme ayarlarını yapılandırabilirsiniz.
  • Üstel geri çekilme: Ardışık hata yanıtları için yeniden denemeler arasında giderek daha uzun bekleme süreleri ile daha iyi akış kontrolü için üstel bir geri çekme algoritması kullanın. Üstel geri çekilme çok uzun geri çekilme sürelerine yol açabilir, çünkü üstel fonksiyonlar hızla büyür. Operasyona ve diğer yerel faktörlere göre ayarlayabileceğiniz maksimum gecikme aralığı ve maksimum sayıda yeniden deneme uygulayın.
  • Titreşim: Tüm istemciler aynı anda yeniden denerse yeniden denemeler etkisiz olabilir. Bu sorunu önlemek için, varış oranını yayarak büyük patlamaları önlemeye yardımcı olmak için bir istek yapmadan veya yeniden denemeden önce rastgele bir süre olan titreşim kullanın. Üstel geri çekme algoritmalarının çoğu, ardışık çarpışmaları önlemek için titreşim kullanır. Daha fazla bilgi için bkz. Üstel Geri Çekme ve Titre.

API isteklerinin sayısını azaltın

Aşağıdaki bölümlerde API isteklerinin sayısını azaltmak için olay tabanlı iş yüklerini, toplu iş işlemlerini ve toplu işlemleri nasıl kullanabileceğiniz açıklanmaktadır.

Olay tabanlı iş yükü

Bildirimleri kullanarak izleyin Bildirimler için Satış Ortağı API'si ve belirli koşullara göre eylemler gerçekleştirin. Bildirimler için Satış Ortağı API'si ile bildirimleri almak, bildirimlere abone olmak, bildirim aboneliklerini silmek vb. için bir hedef oluşturabilirsiniz. Bilgi için anket yapmak yerine, bir etkinlik abone olduğunuz bir bildirimi çağırdığında uygulamanız doğrudan Amazon'dan bilgi alabilir.

Çok var bildirim türleri uygulamanızın yararlanabileceği şekilde kullanılabilir. Daha fazla bilgi için bkz. Bildirimler API v1 Kullanım Örneği Kılavuzu.

Toplu işlemler

Tek bir istekte bir grup öğe için veri alın. SP-API, tek tek çağrılarla aynı eylemi gerçekleştiren, ancak bir seferde bir grup istek için aynı işlemi gerçekleştiren bir dizi toplu işlem destekler. Çağrıları tek tek yapmak yerine, geçerli sayıda istek (çoğunlukla 20) tek bir API çağrısında gönderebilirsiniz.

SP-API şu anda aşağıdaki kullanım durumları için toplu işlemleri desteklemektedir:

  • Katalog API'sini kullanarak ürün arama
  • Teklif veya fiyatlandırma bilgilerini alma
  • Ürünler için ücret tahmini alma

Toplu işlemler

Tek bir API isteğinde toplu verileri yükleyebilir ve indirebilirsiniz.

Verileri toplu olarak yüklemek için şunları kullanabilirsiniz: Beslemeler API'si. Liste oluşturma, envanter ve fiyatları yönetme, siparişleri onaylama vb. Gibi çok çeşitli kullanım durumları için beslemeler vardır. Kullanılabilir besleme türlerinin listesi için bkz. Besleme Türü Değerleri.

Verileri toplu olarak indirmek için şunları kullanabilirsiniz: Rapor API'si ya da Veri Kiosk API'si. Raporlar API'si, envanteri izleme, gönderim siparişlerini izleme, vergi bilgilerini alma, iadeleri ve satıcı performansını izleme, Amazon tarafından Fulfillment ile satış işini yönetme gibi çeşitli kullanım durumları için raporlar sağlar. Raporlar API işlemleri ve ilişkili veri türleri ve şemaları hakkında ayrıntılar için bkz. Rapor API referansı. Mevcut rapor türleri için bkz. Rapor Türü Değerleri.

Data Kiosk API'si, dinamik rapor yetenekleri için GraphQL sorgu işlemlerini destekler. GraphQL, tek bir istekte ihtiyacınız olan verileri talep etmenizi ve almanızı sağlayan API'ler için bir sorgu dilidir. Data Kiosk'un GraphQL tabanlı dinamik raporlama paketi, Amazon veri kümelerinden toplu verilere erişmek için özel GraphQL sorguları oluşturmanıza yardımcı olur. Ayrıntılar için bkz. Veri Kiosk Şema Gezgini Kullanım Kılavuzu.

Diğer en iyi uygulamalar

Aşağıdaki diğer en iyi uygulamaları aklınızda bulundurun:

  • Uygulamanız büyüdükçe kullanımınızı izleyin ve buna göre ölçeklendirin.
  • Gereksiz API çağrılarını ortadan kaldırmak için kodunuzu optimize edin.
  • Tekrarlanan API isteklerine olan ihtiyacı azaltmak için sık kullanılan verileri önbelleğe alın. Nesne düzeyinde depolamayı kullanarak sunucularınızdaki verileri önbelleğe alabilirsiniz. Amazon S3. Ayrıca nispeten statik bilgileri bir veritabanına kaydedebilir veya bir dosyada seri hale getirebilirsiniz.
  • Sırada bekleyen SP-API isteklerini zamana yayın ve sıraya alınan işin çalışmasını beklerken diğer işleme görevlerinizi gerçekleştirin.

Bu sayfa size yardımcı oldu mu?