التغييرات الكاسرة والملحوظة على واجهة v3. نتبع semver — تُشحن التغييرات الإضافية (معاملات اختيارية جديدة، وإجراءات جديدة، وحقول جديدة في الاستجابات) ضمن إصدار رئيسي واحد؛ أما التغييرات الكاسرة فتذهب في إصدار رئيسي جديد.
تقبل إجراءات services وcatalog الآن رمز لغة اختياريًا لأسماء خدمات مُراجعة باستخدام مصطلحات سوقية منتقاة بعشر لغات. تضيف الطلبات الصريحة بيانات الاسم الأساسي واللغة الفعلية، وتعود بأمان إلى الإنجليزية إذا كانت الترجمة مفقودة أو قديمة. من دون language تبقى بنية الاستجابة القديمة بالإنجليزية دون تغيير. يمكن للمشرفين مراجعة كل اسم أو تحسينه.
أصبح /api/v3 نقطة النهاية الأساسية وبديلًا مباشرًا لعنوان URL لعقد إعادة البيع المألوف. يضيف v3 مفاتيح دقيقة اختيارية، وحماية قديمة لمدة 60 ثانية، وكتالوجًا متقدمًا، ومعرّفات رقمية، وrefund_quote، وaccount_status، وإلغاءً فرديًا أو جماعيًا بالتتابع، وويب هوك موقّعًا. تعتمد سعة API الآن على مستوى lifetime successful spend ونافذة متحركة واحدة مدتها 60 ثانية تشترك فيها جميع مفاتيح الحساب. /api/v1 و/api/v2 اسمان مستعاران مطابقان للعقد الحالي.
أُضيف إجراء catalog المقسّم إلى صفحات وإجراء refund_quote للقراءة فقط، ووُسّعت بيانات add وstatus الوصفية، وأُتيحت نافذة إلغاء مدتها 15 ثانية للطلبات العادية عبر API، واسترداد كامل لطلب عادي لم يُحسم بعد 7 أيام من إنشائه الأصلي. تحمل أحداث خطاف الويب في API الآن id ثابتًا للحدث، بينما يبقى deliveryId ثابتًا عبر إعادة محاولات الدفعة نفسها؛ وتحصل كل إعادة محاولة على طابع زمني وتوقيع جديدين. يظل تسليم خطافات الويب وفق أفضل جهد مع إعادة المحاولات، دون ضمان دائم للتسليم مرة واحدة على الأقل.
أُضيفت خدمات لـ Google وRumble وAudiomack وTumblr وKwai وClubhouse وVimeo وDeezer وTidal وApple Music وQuora وGitHub. تظهر في إجراء services كأي خدمة أخرى، ولكلٍّ منها صفحة منصّة علنية مخصّصة. لا حاجة إلى أي تغييرات من جانب العميل — إذ تظهر معرّفات الخدمات الجديدة في الكتالوج ببساطة.
ترفض الخدمات غير المتاحة action=add بدل قبول طلب جديد أو وضعه في الطابور بصمت. حدّث الكتالوج واختر خدمة متاحة قبل إعادة المحاولة.
يقبل الإجراء add الآن حقولًا اختيارية مدعومة خاصة بنوع الخدمة، مثل تأخير البدء وخيارات التفاعل حسب النوع. تحافظ الحقول التي يحددها نوع الخدمة أصلًا على معناها الموثق.
يقبل الإجراء add الحقلين runs وinterval معًا للخدمات التي لديها dripfeed=true. إجمالي التسليم هو quantity × runs ولا يجوز أن يتجاوز الحد الأقصى للخدمة. ترفض الخدمات التي لا تدعم drip-feed هذين الحقلين.
أُطلقت API إجراءات v2 بترميز النماذج مع ضوابط للمعدل وwebhooks موقعة بأفضل جهد مع إعادة المحاولة وإنشاء طلبات متكرر آمن. عناوين v1 وv2 الحالية هي أسماء بديلة لعقد v3 وتستخدم حد الحساب المشترك الموثق.