За разработчици

Свържете 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.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Ù?

Описанието на 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 от името на потребителите.

Започнете интеграцията

Влезте в WŬMÙ, създайте приложение в конзолата за разработчици и получете ключ.