مطوّرو واميا
القائمة

الصلاحيات وحدود المعدل

يحمل المفتاح الصلاحيات الممنوحة فقط. اطلب ما يستخدمه التكامل؛ تسرد صفحة الموافقة كل صلاحية بكلمات بسيطة وترفض المتاجر الطلبات الواسعة.

الصلاحية

الصلاحيةتسمح بـ
offers.manageمطابقة المنتجات أو اقتراحها، إنشاء العروض والأسعار وتعديلها.
catalog.mediaاستيراد الصور عبر رابط أو رفع موقّع وإلحاقها بالمنتجات.
inventory.adjustضبط المخزون المتاح لكل SKU، دفعةً أو فرادى.
orders.readقراءة طلبات واميا وشرائحها وسجل حالاتها.
orders.fulfilالإقرار باستلام الشرائح، تعليمها مجهّزة، التصريح بالشحنات الواردة وحجز المواعيد.
returns.handleقراءة المرتجعات وتسجيل قرار المتجر.
finance:readالرصيد والدفعات والكشوف.
performance:readمؤشرات المتجر: المبيعات وحصة Buy Box والعيوب.
settings:writeإعدادات المتجر التي تعكسها الإضافة (مدة التجهيز، العطل).
webhooks.manageإنشاء نقاط الويب هوك واختبارها وإيقافها وإعادة إرسالها.

حدود المعدل

أربعة دلاء رموز لكل مفتاح تُعبّأ باستمرار وتُشارك بين كل نسخ الواجهة: القراءات، الكتابات، الكتابات الدفعية والميزانية اليومية. تحصل مفاتيح الموصّلات على الميزانية الأكبر؛ تبدأ المفاتيح المخصّصة بالأصغر ويمكن للمتاجر طلب المزيد.

الاسممفتاح مخصّصمفتاح موصّل
قراءات60 في الدقيقة600 في الدقيقة
كتابات60 في الدقيقة300 في الدقيقة
كتابات دفعية5 في الدقيقة20 في الدقيقة
الميزانية اليومية20,000 في اليوم200,000 في اليوم
يُحتسب التعديل الدفعي مرة واحدة على دلو الدفعات مهما كان حجمه، ومرة لكل عنصر على الميزانية اليومية. حين يفرغ دلو يجيب النداء بـ RATE_LIMITED مع extensions.retryAfterSeconds؛ التزم به وأضف عشوائية.

حدود الدفعات

  • حتى 200 عنصر لكل نداء في apiUpsertOffers وapiDeclareStocks وapiMatchListings؛ وما فوقه BATCH_TOO_LARGE.
  • حتى 20 رابط صورة لكل نداء apiIngestMediaFromUrls، 10 ميغابايت لكل صورة، 12 صورة لكل منتج.
  • الأسعار بالمليم كأعداد صحيحة؛ الكميات أعداد صحيحة حتى 10,000,000.
  • تعيد صفحات المؤشر 200 عنصر على الأكثر؛ nextCursor معتم — لا تبنه بنفسك أبدًا.
  • مفاتيح الإدمبوتنسي من 8 إلى 128 حرفًا وتُحفظ 7 أيام؛ تعيد الإعادة ضمن هذه النافذة الإجابة المخزنة.
  • عشر نقاط ويب هوك على الأكثر لكل مفتاح.