Dla programistów

Połącz WŬMÙ ze swoimi systemami

WŬMÙ jest otwarty na integracje na trzy sposoby: aplikacje logują się przez OAuth 2.0 z PKCE i pracują z danymi przez REST API v2 z opisem OpenAPI, a asystenci AI łączą się z serwerem MCP przez adres URL.

Klucze wydaje konsola programisty: zaloguj się do WŬMÙ, utwórz aplikację i otrzymaj client_id.

https://wumu.ai

Autoryzacja
/api/oauth/authorize
Tokeny
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
Serwer MCP
/mcp

Trzy sposoby połączenia

Wybierz, jak się połączyć

Twoja aplikacja lub usługa łączy się przez OAuth i REST API. Asystent AI łączy się przez serwer MCP, bez rejestrowania aplikacji.

  • OAuth 2.0 z PKCE

    Dla stron, usług i aplikacji mobilnych, które za zgodą użytkownika WŬMÙ pracują z jego danymi.

    • Kod autoryzacji z PKCE (S256) i rotacją tokenów odświeżania; client_credentials dla połączeń serwer–serwer
    • Użytkownik widzi ekran zgody i przyznaje tylko potrzebne uprawnienia: profil, dokumenty, czaty, kontakty i inne
    • Klienci publiczni — aplikacje mobilne i SPA — nie dostają sekretu
    • Webhooki podpisane HMAC-SHA256 oraz dziennik żądań i dostarczeń w konsoli programisty
    • Nowa aplikacja zaczyna działać po weryfikacji przez administratora WŬMÙ
  • REST API v2

    API JSON do dokumentów, arkuszy, czatów AI, komunikatora, kontaktów, kalendarza i innych sekcji WŬMÙ.

    • Opis OpenAPI czytelny dla maszyn, z uprawnieniami wymaganymi przez każdą operację
    • Token dostępu przekazuje się w nagłówku Authorization: Bearer
    • Limit żądań na minutę dla każdej pary aplikacja–użytkownik; po jego przekroczeniu odpowiedź to 429
  • Serwer MCP

    Asystent AI łączy się z kontem WŬMÙ przez adres URL — bez kluczy, bez aplikacji programisty i bez instalowania czegokolwiek.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT w trybie programisty, Cursor i inni klienci obsługujący zdalne serwery MCP z logowaniem przez OAuth
    • Logujesz się własnym kontem i sam włączasz sekcje; odczyt i zmiana to osobne przełączniki
    • Sekcje z danymi innych osób — zgłoszenia, komunikator, kontakty — są domyślnie wyłączone
    • Asystenta możesz w każdej chwili odłączyć w ustawieniach bezpieczeństwa konta

    Adres połączenia

    • https://wumu.ai/mcpDla konta w wumu.ai
    • https://wumu.ru/mcpDla konta w wumu.ru (Rosja)

Przykładowe żądanie

Twoje pierwsze żądanie

Uzyskaj token dostępu przez OAuth i przekaż go w nagłówku: pierwsze żądanie zwraca pięć ostatnich czatów z prawnikiem AI i wymaga uprawnienia read:chats. Drugie polecenie dodaje serwer MCP WŬMÙ do Claude Code.

# pięć ostatnich czatów z prawnikiem AI
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# dodaj serwer MCP WŬMÙ do Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
Wszystkie operacje są w opisie OpenAPI

Pytania programistów

Czy do korzystania z API WŬMÙ potrzebny jest płatny plan?

Aplikacje OAuth i REST API v2 nie wymagają płatnego planu: aplikację można utworzyć na dowolnym planie WŬMÙ, także darmowym. Asystenta AI można połączyć z serwerem MCP WŬMÙ także na darmowym planie – z dostępem do profilu, szkiców w mieście i centrum pomocy; pozostałe sekcje wymagają własnego planu Pro lub wyższego, a okres próbny Business też się liczy.

Jak uzyskać klucz API WŬMÙ?

Zaloguj się do WŬMÙ i otwórz konsolę programisty. Utwórz aplikację: nazwa, adresy przekierowania i uprawnienia. Otrzymasz client_id, a aplikacja serwerowa także client_secret — jest pokazywany tylko raz, więc go zapisz. Aplikacja zacznie wydawać tokeny po weryfikacji przez administratora WŬMÙ.

Gdzie znaleźć opis REST API WŬMÙ?

Opis REST API v2 w formacie OpenAPI jest dostępny bez logowania pod adresem /api/v2/openapi.json: wczytaj go do dowolnego narzędzia obsługującego OpenAPI albo wygeneruj z niego klienta. Metadane serwera autoryzacji WŬMÙ są pod adresem /.well-known/openid-configuration.

Otwórz opis OpenAPI
Czy API WŬMÙ ogranicza liczbę żądań?

Tak. REST API v2 ogranicza każdą parę aplikacja–użytkownik: domyślnie 100 żądań na minutę, a niektóre sekcje, np. komunikator, mają własny limit. Po przekroczeniu serwer odpowiada statusem 429 — ponów żądanie później. Asystent AI połączony przez MCP również ma limit żądań na minutę.

Czym serwer MCP WŬMÙ różni się od aplikacji OAuth?

Serwer MCP WŬMÙ to gotowe połączenie dla asystentów AI: nic nie trzeba rejestrować, wystarczy wkleić adres i zalogować się swoim kontem. Aplikacja OAuth jest potrzebna, gdy tworzysz własną integrację — stronę, usługę lub aplikację mobilną, która wywołuje REST API v2 w imieniu użytkowników.

Rozpocznij integrację

Zaloguj się do WŬMÙ, utwórz aplikację w konsoli programisty i odbierz klucz.