DM Champ Docs

واجهة برمجة تطبيقات لوحة Champions Circle

تتوفر لوحة طلبات Champions Circle عبر واجهة برمجة التطبيقات (API)، بحيث يمكنك قراءتها والبحث فيها والنشر عليها من خلال نصوصك البرمجية الخاصة، أو السماح لمساعد ذكاء اصطناعي بالقيام بذلك نيابةً عنك عبر MCP. إنها نفس اللوحة التي تراها ضمن Circle → Requests في التطبيق: نفس الطلبات، ونفس التعليقات، ونفس الحدود الشهرية.

يمكن لأعضاء Champions Circle فقط استخدام نقاط النهاية هذه. سيحصل أي حساب آخر على 403 مع reason: "not_circle_member". يتم إجراء المنشورات باسم الحساب الذي ينتمي إليه مفتاح واجهة برمجة التطبيقات.

نقاط النهاية

الطريقة المسار ما تقوم به
GET /v1/circle/requests سرد اللوحة، مع عرض الطلبات المثبتة أولاً، ثم الأحدث أولاً. ابحث باستخدام q (العنوان والتفاصيل)، وقم بالتصفية باستخدام status (open، planned، building، shipped، declined)، وقم بالتقسيم إلى صفحات باستخدام limit (من 1 إلى 100، الافتراضي 25) و cursor.
GET /v1/circle/requests/{requestId} طلب واحد مع تفاصيله الكاملة.
GET /v1/circle/requests/{requestId}/comments التعليقات على طلب ما، مرتبة من الأقدم، ومقسمة إلى صفحات بنفس الطريقة.
POST /v1/circle/requests تقديم طلب. النص الأساسي: title (مطلوب) و details.
PATCH /v1/circle/requests/{requestId} تعديل title و/أو details لطلب قمت بكتابته. طلب أي شخص آخر سيجيب بـ 403 مع reason: "edit_not_allowed".
POST /v1/circle/requests/{requestId}/comments الرد على طلب. النص الأساسي: body.

يأتي كل طلب مع id و title و details و status و author_name و vote_count و comment_count و created_at و updated_at و url الذي يفتحه في التطبيق. لا يتم إرجاع عناوين البريد الإلكتروني للأعضاء الآخرين أبداً.

التقسيم إلى صفحات

تُرجع استدعاءات القائمة next_cursor. مرره كـ cursor للحصول على الصفحة التالية؛ يكون null في الصفحة الأخيرة. total هو عدد النتائج المطابقة عبر جميع الصفحات.

الحدود الشهرية

تُحتسب منشورات واجهة برمجة التطبيقات ضمن نفس حدود اللوحة في التطبيق: 4 طلبات و4 تعليقات لكل عضو خلال أي 30 يوماً متتالية. عند تجاوز الحد، يجيب الاستدعاء بـ 429 مع وقت resets_at للفتحة المجانية التالية.

عمليات إعادة المحاولة الآمنة

أرسل ترويسة Idempotency-Key (أو حقل idempotency_key في النص الأساسي) مع أي سلسلة فريدة عند تقديم طلب أو تعليق. إذا انتهت مهلة الاستدعاء وأعدت المحاولة بنفس المفتاح، فستستعيد المنشور الذي أنشأه الاستدعاء الأول، مع الحالة 200 و idempotent_replay: true، بدلاً من إنشاء نسخة مكررة. لا تستهلك إعادة المحاولة أبداً فتحة أخرى من حدك الشهري.

curl -X POST "https://api.dmchamp.com/v1/circle/requests" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Idempotency-Key: dark-mode-2026-10-06" \
  -H "Content-Type: application/json" \
  -d '{"title": "Dark mode for the inbox", "details": "My team works late and would love a dark theme."}'

المفاتيح ذات النطاق المحدود

تحتوي اللوحة على قسمين يمكنك منحهما لـ مفتاح ذي نطاق محدد:

القسم يسمح بـ
Circle سرد الطلبات والتعليقات والبحث فيها وقراءتها.
Circle Write تقديم الطلبات، وتعديل طلباتك الخاصة، والتعليق.

امنح فقط Circle للمفتاح الذي يجب أن يقرأ اللوحة فقط. يمكن لمفتاحك الرئيسي، والمفتاح ذي النطاق المحدد مع قائمة tags فارغة، استخدام كليهما.

نبذة عن MCP

تُعد نقاط النهاية هذه جزءاً من مواصفات واجهة برمجة التطبيقات (API)، لذا فهي تظهر كأدوات لأي مساعد ذكاء اصطناعي تقوم بالاتصال به عبر MCP، دون الحاجة إلى إعداد إضافي. اطلب من مساعدك البحث في اللوحة قبل تقديم الطلب، حتى يقوم بالتعليق على طلب موجود بدلاً من تقديم طلب مكرر.