للمطوّرين

اربط WŬMÙ بأنظمتك

WŬMÙ مفتوح للتكامل بثلاث طرق: تسجّل التطبيقات الدخول عبر OAuth 2.0 مع PKCE وتعمل مع البيانات عبر REST API v2 المزوّدة بوصف OpenAPI، بينما يتصل المساعدون الذكيون بخادم MCP عبر رابط.

تصدر المفاتيح في لوحة المطوّر: سجّل الدخول إلى WŬMÙ، وأنشئ تطبيقًا، واحصل على client_id.

https://wumu.ai

التفويض
/api/oauth/authorize
الرموز المميزة
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
خادم MCP
/mcp

ثلاث طرق للاتصال

اختر طريقة الاتصال

يتصل تطبيقك أو خدمتك عبر OAuth وREST API. ويتصل المساعد الذكي عبر خادم MCP دون تسجيل أي تطبيق.

  • OAuth 2.0 مع PKCE

    للمواقع والخدمات وتطبيقات الجوال التي تعمل مع بيانات مستخدم WŬMÙ بموافقته.

    • رمز تفويض مع PKCE (S256) وتدوير رموز التحديث؛ وclient_credentials للاتصال بين الخوادم
    • يرى المستخدم شاشة موافقة ويمنح الصلاحيات اللازمة فقط: الملف الشخصي والمستندات والمحادثات وجهات الاتصال وغيرها
    • العملاء العامّون — تطبيقات الجوال وتطبيقات الصفحة الواحدة — لا يحصلون على سرّ
    • خطافات ويب موقّعة بـ HMAC-SHA256 وسجل للطلبات وعمليات التسليم في لوحة المطوّر
    • يبدأ التطبيق الجديد العمل بعد مراجعته من مسؤول في WŬMÙ
  • REST API v2

    واجهة JSON للمستندات وجداول البيانات ومحادثات الذكاء الاصطناعي والمراسلة وجهات الاتصال والتقويم وأقسام WŬMÙ الأخرى.

    • وصف OpenAPI قابل للقراءة آليًا يحدد الصلاحيات التي تحتاجها كل عملية
    • يُرسل رمز الوصول في الترويسة Authorization: Bearer
    • حدّ لعدد الطلبات في الدقيقة لكل زوج من التطبيق والمستخدم؛ وعند تجاوزه يكون الرد 429
  • خادم MCP

    يتصل المساعد الذكي بحساب WŬMÙ عبر رابط — دون مفاتيح ولا تطبيق مطوّر ولا تثبيت أي برنامج.

    • Claude (claude.ai وClaude Desktop وClaude Code)، وChatGPT في وضع المطوّر، وCursor، وغيرها من العملاء التي تدعم خوادم MCP البعيدة وتسجيل الدخول عبر OAuth
    • تسجّل الدخول بحسابك وتختار الأقسام بنفسك؛ والقراءة والتعديل مفتاحان منفصلان
    • الأقسام التي تحوي بيانات أشخاص آخرين — الطلبات والمراسلة وجهات الاتصال — معطّلة افتراضيًا
    • يمكنك فصل المساعد في أي وقت من إعدادات الأمان في حسابك

    رابط الاتصال

    • https://wumu.ai/mcpلحساب على wumu.ai
    • https://wumu.ru/mcpلحساب على wumu.ru (روسيا)

مثال على طلب

طلبك الأول

احصل على رمز وصول عبر OAuth وأرسله في الترويسة: يعيد الطلب الأول آخر خمس محادثات لك مع المحامي الذكي ويحتاج إلى الصلاحية read:chats. ويضيف الأمر الثاني خادم MCP الخاص بـ WŬMÙ إلى Claude Code.

# آخر خمس محادثات مع المحامي الذكي
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# إضافة خادم MCP الخاص بـ WŬMÙ إلى Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
كل العمليات موجودة في وصف OpenAPI

أسئلة المطوّرين

هل أحتاج إلى خطة مدفوعة لاستخدام واجهة WŬMÙ البرمجية؟

لا تحتاج تطبيقات OAuth وREST API v2 إلى خطة مدفوعة: يمكن إنشاء التطبيق على أي خطة من خطط WŬMÙ، بما فيها المجانية. ويمكن أيضًا ربط مساعد ذكي بخادم MCP الخاص بـ WŬMÙ على الخطة المجانية، مع الوصول إلى ملفك الشخصي ومسودات المدينة ومركز المساعدة؛ أما بقية الأقسام فتحتاج إلى خطة Pro أو أعلى خاصة بك، وتُحتسب الفترة التجريبية لخطة Business أيضًا.

كيف أحصل على مفتاح واجهة WŬMÙ البرمجية؟

سجّل الدخول إلى WŬMÙ وافتح لوحة المطوّر. أنشئ تطبيقًا بالاسم وروابط إعادة التوجيه والصلاحيات. ستحصل على client_id، ويحصل تطبيق الخادم أيضًا على client_secret — يظهر مرة واحدة فقط، فاحفظه. يبدأ التطبيق بإصدار الرموز بعد مراجعته من مسؤول في WŬMÙ.

أين أجد وصف REST API الخاصة بـ WŬMÙ؟

وصف OpenAPI لـ REST API v2 متاح دون تسجيل دخول على العنوان /api/v2/openapi.json: حمّله في أي أداة تفهم OpenAPI أو أنشئ منه عميلًا. وتوجد بيانات خادم التفويض في WŬMÙ على العنوان /.well-known/openid-configuration.

افتح وصف OpenAPI
هل تحدّ واجهة WŬMÙ البرمجية من عدد الطلبات؟

نعم. تحدّ REST API v2 كل زوج من التطبيق والمستخدم: 100 طلبًا في الدقيقة افتراضيًا، ولبعض الأقسام، مثل المراسلة، حدّها الخاص. عند التجاوز يرد الخادم بالحالة 429 — أعد المحاولة لاحقًا. وللمساعد الذكي المتصل عبر MCP أيضًا حدّ للطلبات في الدقيقة.

ما الفرق بين خادم MCP الخاص بـ WŬMÙ وتطبيق OAuth؟

خادم MCP الخاص بـ WŬMÙ اتصال جاهز للمساعدين الذكيين: لا حاجة لتسجيل أي شيء، يكفي لصق الرابط وتسجيل الدخول بحسابك. أما تطبيق OAuth فتحتاجه عندما تبني تكاملك الخاص — موقعًا أو خدمة أو تطبيق جوال يستدعي REST API v2 نيابةً عن المستخدمين.

ابدأ التكامل

سجّل الدخول إلى WŬMÙ، وأنشئ تطبيقًا في لوحة المطوّر، واحصل على مفتاحك.