За програмере

Повежите 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. Друга команда додаје WŬMÙ MCP сервер у Claude Code.

# пет последњих ћаскања са АИ правником
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# додавање WŬMÙ MCP сервера у Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
Све операције су у OpenAPI опису

Питања програмера

Да ли ми треба плаћени пакет за WŬMÙ API?

За OAuth апликације и REST API v2 плаћени пакет није потребан: апликација се прави на било ком WŬMÙ пакету, укључујући бесплатни. АИ асистента можете повезати са WŬMÙ MCP сервером и на бесплатном пакету – са приступом профилу, нацртима у граду и центру за помоћ; за остале одељке потребан вам је сопствени пакет Pro или виши, а пробни период Business се такође рачуна.

Како да добијем WŬMÙ API кључ?

Пријавите се у WŬMÙ и отворите конзолу за програмере. Направите апликацију: назив, адресе за преусмеравање и дозволе. Добићете client_id, а серверска апликација и client_secret — приказује се само једном, сачувајте га. Апликација почиње да издаје токене након провере администратора WŬMÙ.

Где је опис WŬMÙ REST API-ја?

OpenAPI опис REST API v2 доступан је без пријаве на адреси /api/v2/openapi.json: учитајте га у било који алат који разуме OpenAPI или на основу њега генеришите клијента. Параметри WŬMÙ ауторизационог сервера налазе се на адреси /.well-known/openid-configuration.

Отворите OpenAPI опис
Да ли WŬMÙ API ограничава број захтева?

Да. REST API v2 ограничава сваки пар „апликација – корисник“: подразумевано 100 захтева у минуту, а неки делови, на пример месинџер, имају сопствено ограничење. Када се пређе, сервер одговара статусом 429 — поновите захтев касније. АИ асистент повезан преко MCP-а такође има ограничење захтева по минуту.

По чему се WŬMÙ MCP сервер разликује од OAuth апликације?

WŬMÙ MCP сервер је готова веза за АИ асистенте: ништа не треба регистровати, довољно је налепити адресу и пријавити се својим налогом. OAuth апликација вам треба када пишете сопствену интеграцију — сајт, услугу или мобилну апликацију која у име корисника позива REST API v2.

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

Пријавите се у WŬMÙ, направите апликацију у конзоли за програмере и добијте кључ.