למפתחים

חברו את WŬMÙ למערכות שלכם

WŬMÙ פתוח לשילובים בשלוש דרכים: אפליקציות נכנסות דרך OAuth 2.0 עם PKCE ועובדות עם נתונים דרך REST API v2 עם תיאור OpenAPI, ועוזרי בינה מלאכותית מתחברים לשרת MCP באמצעות כתובת URL.

מפתחות מונפקים במסוף המפתחים: היכנסו ל-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 לקריאות משרת לשרת
    • המשתמש רואה מסך הסכמה ומעניק רק את ההרשאות הנחוצות: פרופיל, מסמכים, צ׳אטים, אנשי קשר ועוד
    • לקוחות ציבוריים — אפליקציות מובייל ו-SPA — אינם מקבלים סוד
    • Webhooks חתומים ב-HMAC-SHA256 ויומן של בקשות ומסירות במסוף המפתחים
    • אפליקציה חדשה מתחילה לפעול לאחר בדיקה של מנהל WŬMÙ
  • REST API v2

    API מסוג JSON למסמכים, לגיליונות, לצ׳אטים עם בינה מלאכותית, למסנג׳ר, לאנשי קשר, ליומן ולחלקים נוספים של WŬMÙ.

    • תיאור OpenAPI קריא למכונה, שמציין את ההרשאות הנדרשות לכל פעולה
    • אסימון הגישה נשלח בכותרת Authorization: Bearer
    • מגבלת בקשות לדקה לכל צמד של אפליקציה ומשתמש; בחריגה התשובה היא 429
  • שרת MCP

    עוזר בינה מלאכותית מתחבר לחשבון WŬMÙ באמצעות כתובת URL — בלי מפתחות, בלי אפליקציית מפתחים ובלי התקנה.

    • 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

שאלות של מפתחים

האם צריך תוכנית בתשלום כדי לעבוד עם ה-API של WŬMÙ?

אפליקציות OAuth ו-REST API v2 אינן דורשות תוכנית בתשלום: אפשר ליצור אפליקציה בכל תוכנית של WŬMÙ, כולל החינמית. אפשר לחבר עוזר בינה מלאכותית לשרת ה-MCP של WŬMÙ גם בתוכנית החינמית, עם גישה לפרופיל שלכם, לטיוטות בעיר ולמרכז העזרה; לשאר המדורים נדרשת תוכנית Pro משלכם או גבוהה ממנה, וגם תקופת ניסיון של Business מתאימה.

איך מקבלים מפתח API של 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
האם ה-API של WŬMÙ מגביל את מספר הבקשות?

כן. REST API v2 מגביל כל צמד של אפליקציה ומשתמש: כברירת מחדל 100 בקשות לדקה, ולחלק מהאזורים, כמו המסנג׳ר, יש מגבלה משלהם. בחריגה השרת מחזיר סטטוס 429 — נסו שוב מאוחר יותר. גם לעוזר בינה מלאכותית שמחובר דרך MCP יש מגבלת בקשות לדקה.

במה שונה שרת ה-MCP של WŬMÙ מאפליקציית OAuth?

שרת ה-MCP של WŬMÙ הוא חיבור מוכן לעוזרי בינה מלאכותית: אין צורך לרשום דבר, מספיק להדביק את הכתובת ולהיכנס עם החשבון שלכם. אפליקציית OAuth נחוצה כשאתם בונים שילוב משלכם — אתר, שירות או אפליקציית מובייל שפונים ל-REST API v2 בשם המשתמשים.

התחילו את השילוב

היכנסו ל-WŬMÙ, צרו אפליקציה במסוף המפתחים וקבלו מפתח.