كيفية إصلاح خطأ Amazon API RequestThrottled؟ حدود استخدام Amazon API

نشرت: 2020-05-15

بعد التغييرات الأخيرة في البرنامج التابع لشركة Amazon وتعيين حدود الاستخدام ، بدأ العديد من المستخدمين في مواجهة خطأ Amazon API RequestThrottled. لماذا يظهر هذا الخطأ وكيفية إصلاحه هو شيء سأناقشه في هذا المنشور.

يمكن استخدام Amazon API ، أو واجهة برمجة التطبيقات ، بواسطة مكونات WordPress الإضافية والسمات والأدوات الأخرى للتكامل مع Amazon حتى يتمكنوا من استرداد معلومات المنتج والصور والمراجعات وما إلى ذلك من Amazon.

المكونات الإضافية لـ WordPress & WooCommerce Amazon مثل AAWP و AmaLinksPro و Content Egg (انظر مراجعة Content Egg) و WooZone و ThirstyAffiliates (راجع مراجعة ThirstyAffiliates) ، ولا يمكن للآخرين التفاعل مع خوادم Amazon إذا لم يتم إدراج مفاتيح API أو لا تعمل.

حتى سمات منشئ المتاجر التابعة لـ WordPress Amazon تستخدم واجهة برمجة التطبيقات وأدوات مثل Genius ، والتي يمكن استخدامها لترجمة الروابط التابعة لشركة Amazon تلقائيًا ، من بين العديد من الميزات الأخرى.

تتيح واجهة برمجة التطبيقات لشركة Amazon Associates دمج مواقعها على الويب مع قواعد بيانات Amazon حتى يتمكنوا من استخدام معلومات حول المنتجات التي تُباع على موقع Amazon لعرضها على مواقعهم.

تأكد أيضًا من مراجعة المنشورات حول برنامج Amazon Associates:

  • كيفية إعداد Amazon OneLink واستخدام رابط واحد لإحالة المستخدمين إلى لغة متجر Amazon استنادًا إلى عنوان IP للزائر؟
  • تغييرات في معدل عمولة الشركات التابعة لشركة Amazon (قامت أمازون مؤخرًا بتخفيض عمولات الشركات التابعة مرة أخرى)
  • دليل الشركات التابعة لشركة أمازون - كل ما تحتاج إلى معرفته
  • كيفية تلقي مدفوعات الشركات التابعة لشركة أمازون بسهولة في أي مكان في العالم
  • قواعد الشركات التابعة لشركة أمازون التي يجب عليك اتباعها

جدول المحتويات

Amazon API RequestThrottled Error

من قبل ، أعطت Amazon جميع حسابات Amazon Associate التي كانت في وضع جيد وصولاً غير محدود إلى واجهة برمجة التطبيقات الخاصة بها. تم فرض القيود والقيود اعتبارًا من يناير 2019. والآن ، يتعين على Amazon Associates الحصول على مبيعات مؤهلة تُنسب إلى روابط واجهة برمجة التطبيقات في آخر 30 يومًا لتجنب أن يصبح وصولهم إلى واجهة برمجة التطبيقات إما محدودًا (مقيَّدًا) أو من المحتمل أن يتم إبطاله.

تم أيضًا تغيير حدود الاستخدام اعتبارًا من 23 يناير 2019. والآن يتم تحديد حدود الحساب لاحقًا وفقًا لأداء أرباح الحساب المقترن بناءً على طلبات واجهة برمجة تطبيقات إعلانات المنتجات خلال آخر 30 يومًا (إذا لم تقم بالتحديث إلى Amazon API 5 ، فافعل ذلك. يمكنك استخدامه دون مشاكل).

طلب أمازون
مثال على الرسم البياني لتقارير Amazon Associates.

يتم منح جميع حسابات Product Advertising API 5.0 حدًا للاستخدام بحد أقصى طلب واحد في الثانية ، وهناك حد أقصى يبلغ 8640 طلبًا إجماليًا في اليوم (TPD) على مدار الثلاثين يومًا الأولى بعد الموافقة على حسابك.

بعد ذلك ، سيعتمد استخدام واجهة برمجة تطبيقات إعلانات المنتج (PA) على عائدات الصنف المشحونة لكل حساب نشط. ستتلقى الحسابات بعد ذلك إما 1 TPS (بحد أقصى 10) لكل 4320 دولارًا أمريكيًا من عائدات عنصر المنتج المشحون أو 1 TPD لكل 5 سنتات من الإيرادات الناتجة باستخدام Product Advertising API لشحناتها في فترة الثلاثين يومًا السابقة.

إذا كان حسابك لا يحقق عائدات كافية وفقًا لهذه المعايير لفترات متتالية مدتها 30 يومًا ، فلن يتمكن حسابك من الوصول إلى واجهة برمجة تطبيقات إعلانات منتجات أمازون.

لمعرفة ما إذا كانت مبيعاتك تُنسب مباشرةً إلى طلبات (أو مكالمات) PA API التي تجريها ، ابحث عن المعلومات التالية:

  • يتم استخدام حسابك الأساسي في جميع استدعاءات Product Advertising API.
  • تمر علامة Associate الخاصة بك في جميع استدعاءات واجهة برمجة تطبيقات إعلانات المنتج.
  • أنت تستخدم الروابط التي توفرها واجهة برمجة تطبيقات Product Advertising عند الرجوع إلى Amazon.
  • تم إنشاء كل من واجهة برمجة تطبيقات Product Advertising وحساب Associate باستخدام نفس عنوان البريد الإلكتروني أو حساب Amazon.

يمكنك استخدام أداة تقارير Associates Central لإنشاء تقرير يعرض جميع مبيعاتك المنسوبة إلى طلبات PA API الخاصة بك.

يمكن العثور على التقرير باتباع الخطوات التالية:

  1. ابدأ بتسجيل الدخول إلى حساب Amazon Associates الخاص بك.
  2. ابحث عن مربع "ملخص هذا الشهر" الذي يظهر على الجانب الأيمن.
  3. ابحث عن زر "عرض التقرير الكامل" في الأسفل وانقر فوقه.
  4. حدد القائمة المنسدلة للإطار الزمني.
  5. اختر آخر 30 يومًا كإطار زمني للتقرير.
  6. يحتوي المربع الثاني الذي يظهر (أسفل تقرير الأرباح مباشرةً) على ثلاث علامات تبويب. ستظهر "العناصر المطلوبة" تلقائيًا بشكل افتراضي.
  7. انقر فوق علامة التبويب "أداء نوع الارتباط".
  8. يمكنك هنا العثور على جميع التحويلات والنقرات التي تُنسب مباشرةً إلى واجهة برمجة تطبيقات إعلانات المنتجات من Amazon.

خطأ في واجهة برمجة تطبيقات أمازون
يمكنك التحقق من عدد المبيعات التي تم إحالتها باستخدام Amazon API.

ستعرض واجهة برمجة تطبيقات إعلانات المنتج رسالة خطأ 503 إذا تم إبطال وصولك. ستظهر رسالة الخطأ نفسها أيضًا إذا كنت تحاول إرسال مكالمات تتجاوز حد استخدام حسابك.

لا يزال بإمكانك استخدام Site Stripe لتحقيق أرباح إذا لم تتمكن من الوصول إلى Product Advertising API. يمكن استعادة الوصول إلى API. يحدث هذا عادةً في غضون يومين بمجرد شحن عناصر المبيعات المُحالة إلى العملاء.

كي تختصر

وضعت أمازون القواعد الجديدة التالية:

  • تحتاج حسابات Amazon Affiliate الجديدة تمامًا إلى التحقق من معلومات موقع الويب الخاص بها وإنشاء ما لا يقل عن 3 مبيعات أو أكثر قبل أن يتمكنوا من الوصول إلى مفاتيح API.
  • لن تبدأ أي مفاتيح API جديدة يتم إنشاؤها في العمل إلا بعد 48 ساعة.
  • سيفقد حسابك إمكانية الوصول إلى Product Advertising API إذا لم يحيل ثلاث عمليات بيع على الأقل في آخر 30 يومًا.
  • حد الاستخدام الأولي ، وفقًا لوثيقة واجهة برمجة تطبيقات إعلانات المنتجات من أمازون ، هو 8640 طلبًا في اليوم. سيتم تحديد حدود الحساب بناءً على أداء إيرادات Product API على مدار 30 يومًا.

ستظهر رسالة خطأ ، "RequestThrottled - حدث خطأ ما. يرجى التحقق من مفاتيح API الخاصة بك "إذا كان حساب Amazon Affiliate الخاص بك لا يلتزم بهذه القواعد. سيتم عرض رسالة الخطأ في صفحة إعدادات API الخاصة بالمكون الإضافي.

كيف تتحقق مما إذا كانت مفاتيح API الخاصة بك تعمل؟

هناك طريقتان يمكنك من خلالهما التحقق لمعرفة ما إذا كانت مفاتيح Amazon تعمل:

1. غير رسمي: تحقق سريعًا باستخدام مدقق مفاتيح واجهة برمجة تطبيقات أمازون

2. رسمي: Amazon AWS Scratchpad - يمكن أن تمنحك Scratchpad تقريرًا موسعًا عن خطأ مفتاح API. ما عليك سوى اتباع خطوات بسيطة:

  • ابدأ بأداة Amazon AWS Scratchpad.
  • انظر إلى العمود الأيسر للعثور على اختيار "SearchItems". سيؤدي النقر فوق هذا الخيار إلى إظهار نموذج يتطلب منك إدخال معرف التتبع ومفتاح Amazon API ومعلومات مفتاح الوصول السري.
  • انقر فوق الزر "طلب تشغيل" بمجرد إدخال هذه البيانات.
  • سيعرض لك قسم "الاستجابة" نتائجك.

ملاحظة: تأكد من عدم حظر حساب Amazon الخاص بك بسبب أي من القواعد أو القيود المذكورة أعلاه. خلاف ذلك ، قد لا يعمل التقرير بشكل صحيح.

كيفية حل خطأ "RequestThrottled" الخاص بواجهة Amazon API؟

قد لا تضمن الاقتراحات التالية أن مفاتيح API الخاصة بك ستعمل. ومع ذلك ، يمكنهم بالتأكيد المساعدة إذا كنت تواجه مشاكل:

  • يجب أن تنتظر 48 ساعة على الأقل حتى يتم تنشيط أي مفاتيح جديدة لواجهة برمجة التطبيقات قبل استخدامها (بعد إنشائها).
  • تحقق من معلومات المبيعات الخاصة بك للتأكد من أنك قد أجريت ثلاث عمليات بيع على الأقل أو أكثر باستخدام واجهة برمجة تطبيقات إعلانات المنتجات من أمازون في غضون 30 يومًا.
  • حاول ألا تستخدم نفس مفاتيح API على مواقع متعددة . يجب أن يتم ذلك فقط إذا كان لديك مبيعات كافية تبرر استدعاءات API إضافية.

لسوء الحظ ، لا يمكنك فعل أي شيء من جانبك لحل أخطاء واجهة برمجة التطبيقات. يجب إرسال أي أسئلة أو استفسارات إلى فريق Amazon's Associate.

يمكن أن يساعد المكون الإضافي AmaLinksPro الأعضاء الجدد في Amazon Affiliate على إجراء المبيعات الثلاثة الأولى المطلوبة للوصول إلى واجهة برمجة التطبيقات. المكون الإضافي سهل الاستخدام ، ولا تحتاج إلى أن يكون لديك مفتاح API نشط لتتمكن من إضافة روابط تابعة على موقع الويب الخاص بك. يمكنك أيضًا استخدام وحدة Content Egg Amazon No API.

كيف يمكنني استعادة الوصول إلى Amazon API؟

عادةً ما يحدث خطأ متقطع في Amazon API إذا لم يكن لديك مبيعات كافية خلال فترة زمنية تبلغ 30 يومًا. ولكن كيف يمكنني استعادة الوصول إلى واجهة برمجة التطبيقات؟ كيف يمكنني تحقيق مبيعات كافية منسوبة إلى واجهة برمجة تطبيقات أمازون إذا لم يكن لدي وصول إلى واجهة برمجة التطبيقات؟

عادةً ما يقتصر الأعضاء التابعون على استخدام الموارد التي توفرها Amazon فقط لإنشاء روابط تنسبهم إلى API. يمكنك إنشاء هذه الروابط أو التحقق منها عن طريق تسجيل الدخول إلى حساب Amazon Associates الخاص بك ثم تحديد خيار "Product Linking" .

يعد Site Stripe أحد أكثر الأدوات شيوعًا التي تستخدمها Amazon. كل ما عليك فعله لاستخدام Site Stripe هو تسجيل الدخول إلى حساب Amazon Affiliate ثم فتح موقع Amazon.

سيظهر شريط Site Stripe في أعلى كل صفحة لأي منتج من منتجات Amazon. يمكنك البحث عن العديد من المنتجات على Amazon واستخدام Site Stripe لإنشاء أنواع الروابط. يمكن بعد ذلك نسخ كل نوع ارتباط تقوم بإنشائه ولصقه في صفحاتك أو منشوراتك على الموقع. ثم بعد إنشاء المبيعات ، سيكون لديك حق الوصول إلى API مرة أخرى.

إذا كنت بحاجة إلى أداة بحث جيدة عن منتج أمازون ، فراجع مراجعة AMZScout الخاصة بي لأنها واحدة من أفضل الموارد المتوفرة لبائعي أمازون. يمكن أن تساعد أدوات بحث بيانات المنتج والسوق في نجاح أعمالك.