سجل تغييرات الـ API

أبرز التغييرات في سطح الـ API وفي هذا التوثيق. التواريخ بتوقيت UTC.

2026-09-06

جديد: OAuth 2.1 لخادم MCP — تسجيل عملاء ديناميكي، وPKCE بطريقة S256 حصرًا، ورموز تجديد دوّارة مع كشف إعادة الاستخدام، وصفحة موافقة للتاجر. صار بإمكان مساعد ذكي الاتصال بمتجر دون أن يتداول أحد مفتاح API، ويلغي التاجر أي اتصال من الإعدادات ← MCP.
جديد: يتصل ChatGPT كموصّل مخصص في وضع المطوّر عبر OAuth؛ وتوثيق إعداد Codex CLI.
توثيق: كانت أداتان من أدوات منشئ المتجر ناقصتين في مرجع الأدوات — builder_get_theme_schema وbuilder_create_menu. فالخادم يوفّر 33 أداة لا 31.
توثيق: صُحّح التعميم القائل إن كتابات منشئ المتجر لا تقع إلا على مسودات — فـ builder_create_menu تنشئ قوائم جديدة مباشرةً لأن القوائم غير محفوظة بنسخ.
قيد معروف: تحتاج get_review_summary صلاحية REVIEWS التي لا يمنحها أي نطاق OAuth؛ فهي متاحة بمفتاح API فقط.

جديد: خادم MCP — عنوان بروتوكول Model Context Protocol على POST /mcp يتيح لمساعد ذكي قراءة بيانات المتجر بمفتاح API. 12 أداة للقراءة فقط؛ راجع مرجع الأدوات.

التوثيق: تصحيح المسارات الموثّقة — عناوين الموظفين تحت /staff (كانت موثّقة /user)، وإلغاء الطلب هو POST /order/vendor/cancel/{orderId}، وتفاصيل الطلب GET /order/details/{orderId}، وقائمة الطلبات GET /order/vendor.
التوثيق: أصبح دليل المصادقة يغطي ترويستَي tt-api-key وAuthorization: Bearer، ونموذج الصلاحيات الحقيقي (أزواج المورد والإجراء)، وجدول أخطاء المصادقة كاملًا.
التوثيق: صفحات جديدة — الويب هوك ومرجع الصلاحيات والبيئات.
التوثيق: تصحيح توثيق حدود المعدل: الحد الافتراضي 140 طلبًا لكل نافذة منزلقة مدتها 60 ثانية؛ والترويسة X-RateLimit-Reset تمثل الثواني المتبقية حتى تحرّر السعة، لا طابعًا زمنيًا.