Fejlesztőknek

Kapcsolja a WŬMÙ-t a saját rendszereihez

A WŬMÙ háromféleképpen nyitott az integrációkra: az alkalmazások OAuth 2.0-val és PKCE-vel jelentkeznek be, és az OpenAPI-leírással ellátott REST API v2-n keresztül dolgoznak az adatokkal, az MI-asszisztensek pedig egy URL-lel csatlakoznak az MCP-szerverhez.

A kulcsot a fejlesztői konzolban kapja meg: jelentkezzen be a WŬMÙ-be, hozzon létre egy alkalmazást, és kapja meg a client_id-t.

https://wumu.ai

Engedélyezés
/api/oauth/authorize
Tokenek
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP-szerver
/mcp

Három csatlakozási mód

Válassza ki, hogyan csatlakozik

Saját alkalmazása vagy szolgáltatása OAuth-on és a REST API-n keresztül csatlakozik. Az MI-asszisztens az MCP-szerveren keresztül, alkalmazás regisztrálása nélkül.

  • OAuth 2.0 PKCE-vel

    Weboldalaknak, szolgáltatásoknak és mobilalkalmazásoknak, amelyek egy WŬMÙ-felhasználó beleegyezésével dolgoznak az adataival.

    • Engedélyezési kód PKCE-vel (S256) és a frissítési tokenek rotációjával; szerverek közötti hívásokhoz client_credentials
    • A felhasználó beleegyezési képernyőt lát, és csak a szükséges jogosultságokat adja meg: profil, dokumentumok, csevegések, névjegyek és továbbiak
    • A nyilvános kliensek — mobilalkalmazások és SPA-k — nem kapnak titkos kulcsot
    • HMAC-SHA256-tal aláírt webhookok, valamint kérés- és kézbesítési napló a fejlesztői konzolban
    • Egy új alkalmazás a WŬMÙ adminisztrátorának ellenőrzése után kezd működni
  • REST API v2

    JSON API a dokumentumokhoz, táblázatokhoz, MI-csevegésekhez, az üzenetküldőhöz, a névjegyekhez, a naptárhoz és a WŬMÙ más részeihez.

    • Géppel olvasható OpenAPI-leírás, amely minden művelethez megadja a szükséges jogosultságokat
    • A hozzáférési token az Authorization: Bearer fejlécben megy
    • Percenkénti kéréskorlát minden alkalmazás–felhasználó párra; túllépéskor a válasz 429
  • MCP-szerver

    Az MI-asszisztens egy URL-lel csatlakozik a WŬMÙ-fiókhoz — kulcs, fejlesztői alkalmazás és telepítés nélkül.

    • Claude (claude.ai, Claude Desktop, Claude Code), fejlesztői módban a ChatGPT, a Cursor és más kliensek, amelyek támogatják a távoli MCP-szervereket OAuth-bejelentkezéssel
    • Saját fiókjával jelentkezik be, és maga kapcsolja be a részeket; az olvasás és a módosítás külön kapcsoló
    • A mások adatait tartalmazó részek — megkeresések, üzenetküldő, névjegyek — alapértelmezés szerint ki vannak kapcsolva
    • Az asszisztenst bármikor leválaszthatja a fiókja biztonsági beállításaiban

    Csatlakozási URL

    • https://wumu.ai/mcpwumu.ai-fiókhoz
    • https://wumu.ru/mcpwumu.ru-fiókhoz (Oroszország)

Példakérés

Az első kérése

Szerezzen hozzáférési tokent OAuth-on keresztül, és adja át a fejlécben: az első kérés az MI-jogásszal folytatott öt legutóbbi csevegését adja vissza, és a read:chats jogosultság kell hozzá. A második parancs hozzáadja a WŬMÙ MCP-szerverét a Claude Code-hoz.

# az öt legutóbbi csevegés az MI-jogásszal
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# a WŬMÙ MCP-szerverének hozzáadása a Claude Code-hoz
claude mcp add --transport http wumu https://wumu.ai/mcp
Minden művelet az OpenAPI-leírásban található

Fejlesztői kérdések

Kell fizetős csomag a WŬMÙ API használatához?

Az OAuth-alkalmazásokhoz és a REST API v2-höz nem kell fizetős csomag: alkalmazást bármelyik WŬMÙ-csomagban létrehozhat, az ingyenesben is. MI-asszisztenst az ingyenes csomagban is csatlakoztathat a WŬMÙ MCP-szerveréhez – a profiljához, a városi piszkozataihoz és a súgóközponthoz hozzáféréssel; a többi részhez saját Pro vagy magasabb csomag kell, a Business próbaidőszak is megfelel.

Hogyan kaphatok WŬMÙ API-kulcsot?

Jelentkezzen be a WŬMÙ-be, és nyissa meg a fejlesztői konzolt. Hozzon létre egy alkalmazást névvel, átirányítási címekkel és jogosultságokkal. Kap egy client_id-t, szerveroldali alkalmazás esetén egy client_secretet is — ez csak egyszer jelenik meg, őrizze meg. Az alkalmazás akkor kezd tokeneket kiadni, ha a WŬMÙ adminisztrátora ellenőrizte.

Hol találom a WŬMÙ REST API leírását?

A REST API v2 OpenAPI-leírása bejelentkezés nélkül elérhető a /api/v2/openapi.json címen: töltse be bármely OpenAPI-t értő eszközbe, vagy generáljon belőle klienst. A WŬMÙ engedélyezési szerverének metaadatai a /.well-known/openid-configuration címen vannak.

OpenAPI-leírás megnyitása
Korlátozza a WŬMÙ API a kérések számát?

Igen. A REST API v2 minden alkalmazás–felhasználó párt korlátoz: alapértelmezés szerint percenként 100 kérés, egyes részeknek, például az üzenetküldőnek, saját korlátja van. Túllépéskor a szerver 429-es állapottal válaszol — próbálja újra később. Az MCP-n keresztül csatlakozó MI-asszisztensnek is van percenkénti kéréskorlátja.

Miben különbözik a WŬMÙ MCP-szervere egy OAuth-alkalmazástól?

A WŬMÙ MCP-szervere kész kapcsolat MI-asszisztensek számára: semmit sem kell regisztrálni, elég beilleszteni a címet és bejelentkezni a fiókjával. OAuth-alkalmazás akkor kell, ha saját integrációt készít: weboldalt, szolgáltatást vagy mobilalkalmazást, amely a felhasználók nevében hívja a REST API v2-t.

Kezdje el az integrációt

Jelentkezzen be a WŬMÙ-be, hozzon létre egy alkalmazást a fejlesztői konzolban, és kapja meg a kulcsát.