За разработчици
Свържете 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 — не получават тайна
- Уебхукове, подписани с HMAC-SHA256, и дневник на заявките и доставките в конзолата за разработчици
- Новото приложение започва да работи след проверка от администратор на WŬMÙ
REST API v2
JSON API за документи, таблици, ИИ чатове, месинджъра, контакти, календара и други раздели на 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.aihttps://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Въпроси на разработчици
Нужен ли е платен план, за да ползвам 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Ù?
Описанието на REST API v2 във формат OpenAPI е достъпно без вход на адрес /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 от името на потребителите.