سجل تغييرات واجهة البرمجة

ما تغيّر في واجهة البوتات وفي هذه الصفحات، الأحدث أولًا. الإصدار هو ما يذكره GET / في zrzur.

curl "https://api.zrzur.com/"
# answer, shortened: { "zrzur": "26.0.0", ... }

يذكر كل بند هل يجب أن تتغير البوتات الموجودة. ويُعلن كل حذف هنا مع تاريخه قبل وقوعه. تابعه في قارئ الخلاصات: خلاصة RSS.

منذ 26.0.0

يعمل على api.zrzur.com، وتُحقِّق منه في 2026-11-13. ما زال GET / يعيد 26.0.0. تبقى البوتات الموجودة تعمل: لا شيء مما يلي يحذف حقلًا أو يغيّره.

• البوابة: الاستئناف. تحمل كل حزمة بعد Ready الحقل seq، ويُعدّ لكل جلسة بدءًا من 1. أرسل Authenticate مع "resumable": true فيحمل Ready القيمة session_id. بعد الانقطاع تُحفظ الجلسة دقيقتين مع آخر 1000 حدث على الأكثر و4 ميبيبايت منها. وعلى مقبس جديد أرسل Resume أول رسالة: تصل الأحداث التي بعد seq بالترتيب، ثم Resumed. وإن زالت الجلسة يصلك InvalidSession مع "resumable": false؛ فأرسل Authenticate على المقبس نفسه واستدرك ما فاتك عبر REST. ويسرد GET /gateway/schema رموز الإغلاق وحدود الاستئناف. انظر البوابة.
• البوت يقرأ إعداداته. يعيد GET /bots/{bot_id} بمعرّف البوت نفسه ورمزه قيمة privileged_intents. ومعرّف بوت آخر يجيب بـIsBot.
• رفض أوضح للنيّات. يسمّي سبب الإغلاق 4014 ما قرأه الخادم، مثل Disallowed intents: MESSAGE_CONTENT (switched on: none). وإن لم يستطع الخادم قراءة إعدادات البوت أرسل InternalError وأغلق بالرمز 1013: أعد المحاولة لاحقًا ولا تتوقف.
• المواضيع: رسالة أولى أغنى. يأخذ POST /channels/{target}/threads الحقلين embeds وcomponents بجانب content، بقواعد إرسال الرسالة: تسري صلاحية إرسال التضمينات، ويُرفض ذكر دور دون Mention Roles بـ403 MissingPermission ولا يبقى موضوع. انظر القنوات.
• «غير مثبّت» يجيب بـ404. يجيب GET /channels/{target} بـ404 NotFound كل من ليس في سيرفر القناة، كالسيرفر نفسه وكقناة غير موجودة. ويبقى العضو الذي لا يملك الوصول يحصل على 403 MissingPermission. انظر الأخطاء.
• الأوامر في رسالة خاصة. يستطيع الشخص استخدام أوامر البوت العامة التي لا تتطلب صلاحية في سيرفر، في رسالته الخاصة مع البوت.
• قواعد الأوامر لكل سيرفر. يستطيع من يملك إدارة السيرفر وإدارة الأدوار السماح بأوامر تطبيق أو منعها للأدوار والأعضاء والقنوات: GET وPUT /servers/{server_id}/applications/{application_id}/permissions، وPUT /servers/{server_id}/applications/{application_id}/commands/{command_id}/permissions.
• الاستطلاعات والفعاليات المجدولة ولوحة الأصوات والمنصّات. مسارات وأحداث بوابة جديدة، مسرودة في مرجع الرسائل والسيرفرات والمكالمات الصوتية وفي مرجع الأحداث. وصلاحيتان جديدتان: UseSoundboard وManageSoundboard. تُفعَّل الاستطلاعات وإعادة التوجيه والفعاليات المجدولة لكل تنصيب على حدة (features في GET /)، وكانت معطّلة على api.zrzur.com عند التحقق من هذه الصفحة.
• المكتبة: حدود المعدل والاستئناف. تستأنف المكتبة افتراضيًا للبوتات، وتنتظر انقضاء 429، وتنتظر إعادة الضبط حين يفرغ الرصيد. ليست على npm بعد، وانظر المكتبات.

التوثيق، 2026-11-09

لا تغيير في الواجهة. تقول هذه الصفحات الآن ما اضطر كاتب بوت إلى اكتشافه بالتجربة:

• يُفتح التوثيق فورًا، دون تسجيل دخول ودون انتظار اتصال.
• مرجع الأحداث: أنواع القنوات، وكيف تميّز الرسالة الخاصة من رسالة السيرفر.
• البوابة: ما تفعله حين تكون نية خاصة معطلة، ومتى يسري المفتاح.
• دون مكتبة: يرسل مثال Node القيمة intents: 33 كالنص ومثال Python.
• القنوات والويب هوك: يأتي HTTP المباشر أولًا، مع جسم POST /servers/{server}/channels بالحقلين private وcategory، وقواعد الرسالة الأولى في الموضوع.
• أوامر الشرطة المائلة: أين يصل ملف خيار Attachment، ولماذا لا يُرسل معرّفه مرة أخرى.
• الرسائل: روابط القنوات <#id>، وجواب GET /channels/{target}/messages وترتيبه.
• نظرة عامة: نموذج لجواب GET /.
• الأخطاء: أي جواب يعني «البوت ليس في ذلك السيرفر».
• لا يذكر المرجع إلا حزمة البوتات، وتتفق شارة الحالة مع الفحص المذكور تحتها.

26.0.0 (2026-11-08)

أول إصدار من زرزور، وكل ما في هذه الصفحات يصفه.

• التفاعلات: أوامر الشرطة المائلة مع الخيارات والاختيارات والأوامر الفرعية والأسماء المترجمة والإكمال التلقائي؛ وأوامر قوائم المستخدم والرسالة؛ والأزرار والقوائم والنماذج؛ والإجابات الخاصة والمؤجلة واللاحقة. وتعمل الأزرار والنماذج أيضًا في رسالة خاصة مع البوت.
• التفاعلات عبر HTTP، بطلبات موقّعة إلى عنوانك.
• نيّات البوابة تحدد ما يستقبله الاتصال. والنيّات MESSAGE_CONTENT وSERVER_MEMBERS وPRESENCE خاصة وتُفعَّل في بوابة المطورين. ويصف GET /gateway/schema كل حدث.
• المواضيع والمنتديات: POST وGET /channels/{target}/threads وPATCH /channels/{target}/thread، مع الصلاحيات CreateThreads وCreateForumPosts وSendMessageInThreads.
• عبر REST: POST /channels/{target}/typing، والرسائل المثبتة عبر POST /channels/{target}/search مع pinned: true.
• الويب هوك: تظهر الرموز مرة واحدة، وتبدأ بـzrzur_wh_، ويمكن استبدالها.
• حدود المعدل: يحمل جسم 429 القيمة retry_after بالميلي ثانية وglobal. ولكل خطأ type ثابت.
• OAuth2 مع PKCE.

التالي

• الحالة والتغطية
• الأخطاء