آخر تحديث
سجل التغييرات
ما الذي تغيّر في واجهة API، من الأحدث إلى الأقدم. تُطرح التغييرات غير المتوافقة تحت بادئة إصدار جديدة؛ ويبقى كل ما في v1 متوافقًا مع الإصدارات السابقة.
- تغييرإعادة تسمية ترويسات Webhookتحمل إرسالات Webhook الآن الترويسات x-roomscope-signature وx-roomscope-timestamp وx-roomscope-alert-id وx-roomscope-schema-version. لم يتغير مخطط التوقيع ولا الحمولة؛ اقرأ أسماء الترويسات الجديدة عند التحقق.
- إصلاحالتوثيق مطابق لواجهة APIتصف صفحات الأخطاء ووحدات الرصيد وحدود المعدّل والمصادقة وWebhooks الآن السلوك الفعلي: رموز الأخطاء الحقيقية، وحدود المعدّل لكل مفتاح مع ترويسات X-RateLimit، وتكاليف وحدات الرصيد والحصص الشهرية، ومخطط webhook الموقّع. ويضيف المرجع رؤى صنّاع المحتوى وأفضل وقت للبث والحضور. والبحث في التوثيق مفعّل (⌘K).
- إضافةقالب توثيق APIالبدء، والمصادقة، والأخطاء، وحدود المعدّل، ومرجع التصنيفات، وWebhooks. وستتبعها صفحات المرجع لبقية الموارد بمجرد توليدها من مستند OpenAPI.
- تغييرغلاف الخطأيُرجع كل خطأ الآن { code, message, requestId, retryable }. ينبغي للعملاء التفرّع بناءً على code وعدم إعادة المحاولة إلا عندما تكون قيمة retryable هي true.
- إضافةالتصنيفات: كتلة مصدر البياناتتُرجع GET /v1/rankings/official كائن provenance (coverageStatus، observedAt) بجانب data.
- إضافةمفاتيح API محددة النطاقتحمل المفاتيح نطاقات صريحة (rank:read، live:read، creator:read، …). تفشل الطلبات الواقعة خارج نطاقات المفتاح بالخطأ 403 insufficient_scope.
هل كانت هذه الصفحة مفيدة؟