Kehittäjille

Yhdistä WŬMÙ järjestelmiisi

WŬMÙ on avoin integraatioille kolmella tavalla: sovellukset kirjautuvat OAuth 2.0 -protokollalla ja PKCE:llä ja käsittelevät tietoja REST API v2 -rajapinnan kautta, jolle on OpenAPI-kuvaus, ja tekoälyavustajat yhdistyvät MCP-palvelimeen URL-osoitteella.

Avaimet myönnetään kehittäjäkonsolissa: kirjaudu WŬMÙ-palveluun, luo sovellus ja saat client_id-tunnuksesi.

https://wumu.ai

Valtuutus
/api/oauth/authorize
Käyttöoikeustunnukset
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP-palvelin
/mcp

Kolme tapaa yhdistää

Valitse yhdistämistapa

Oma sovelluksesi tai palvelusi yhdistyy OAuth-valtuutuksen ja REST API -rajapinnan kautta. Tekoälyavustaja yhdistyy MCP-palvelimen kautta, eikä sovellusta tarvitse rekisteröidä.

  • OAuth 2.0 ja PKCE

    Verkkosivustoille, palveluille ja mobiilisovelluksille, jotka käsittelevät WŬMÙ-käyttäjän tietoja tämän suostumuksella.

    • Valtuutuskoodi ja PKCE (S256) sekä päivitystunnusten kierto; client_credentials palvelinten välisiin kutsuihin
    • Käyttäjä näkee suostumusnäkymän ja myöntää vain tarvitsemasi käyttöoikeudet: profiili, asiakirjat, chatit, yhteystiedot ja muuta
    • Julkiset asiakkaat – mobiilisovellukset ja SPA-sovellukset – eivät saa salaisuutta
    • HMAC-SHA256-allekirjoitetut webhookit sekä pyyntö- ja toimitusloki kehittäjäkonsolissa
    • Uusi sovellus otetaan käyttöön, kun WŬMÙ-ylläpitäjä on tarkistanut sen
  • REST API v2

    JSON-rajapinta asiakirjoihin, laskentataulukoihin, tekoälychatteihin, Pikaviestimeen, yhteystietoihin, kalenteriin ja muihin WŬMÙ-palvelun osiin.

    • Koneluettava OpenAPI-kuvaus, joka kertoo, mitä käyttöoikeuksia kukin toiminto tarvitsee
    • Käyttöoikeustunnus välitetään Authorization: Bearer -otsakkeessa
    • Minuuttikohtainen pyyntöraja jokaiselle sovelluksen ja käyttäjän parille; rajan ylitys palauttaa koodin 429
  • MCP-palvelin

    Tekoälyavustaja yhdistyy WŬMÙ-tiliin URL-osoitteella – ei avaimia, ei kehittäjäsovellusta eikä mitään asennettavaa.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT kehittäjätilassa, Cursor ja muut asiakkaat, jotka tukevat etä-MCP-palvelimia ja OAuth-kirjautumista
    • Kirjaudut omalla tililläsi ja valitset osiot itse; tietojen lukemisella ja muuttamisella on omat kytkimensä
    • Osiot, joissa on muiden ihmisten tietoja – pyynnöt, Pikaviestin, yhteystiedot – ovat oletuksena pois päältä
    • Voit katkaista avustajan yhteyden milloin tahansa tilisi suojausasetuksissa

    Yhteyden URL-osoite

    • https://wumu.ai/mcpTilille osoitteessa wumu.ai
    • https://wumu.ru/mcpTilille osoitteessa wumu.ru (Venäjä)

Esimerkkipyyntö

Ensimmäinen pyyntösi

Hanki käyttöoikeustunnus OAuth-valtuutuksella ja välitä se otsakkeessa: ensimmäinen pyyntö palauttaa viisi viimeisintä chattiasi Tekoälyjuristin kanssa ja tarvitsee read:chats-käyttöoikeuden. Toinen komento lisää WŬMÙ MCP -palvelimen Claude Code -työkaluun.

# viisi viimeisintä chattiasi Tekoälyjuristin kanssa
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# lisää WŬMÙ MCP -palvelin Claude Code -työkaluun
claude mcp add --transport http wumu https://wumu.ai/mcp
Kaikki toiminnot löytyvät OpenAPI-kuvauksesta

Kehittäjien kysymyksiä

Tarvitsenko maksullisen paketin käyttääkseni WŬMÙ API -rajapintaa?

OAuth-sovellukset ja REST API v2 eivät vaadi maksullista pakettia: voit luoda sovelluksen missä tahansa WŬMÙ-paketissa, myös maksuttomassa. Tekoälyavustaja voi yhdistyä WŬMÙ MCP -palvelimeen myös maksuttomassa paketissa, ja sillä on pääsy profiiliisi, kaupunkiluonnoksiisi ja ohjekeskukseen; muut osiot vaativat oman Pro-paketin tai ylemmän, ja myös Business-kokeilujakso käy.

Miten saan WŬMÙ API -avaimen?

Kirjaudu WŬMÙ-palveluun ja avaa kehittäjäkonsoli. Luo sovellus ja anna sille nimi, uudelleenohjausosoitteet ja käyttöoikeudet. Saat client_id-tunnuksen, ja palvelinpuolen sovellus saa lisäksi client_secret-salaisuuden – se näytetään vain kerran, joten säilytä se turvallisesti. Sovellus alkaa myöntää käyttöoikeustunnuksia, kun WŬMÙ-ylläpitäjä on tarkistanut sen.

Mistä löydän WŬMÙ REST API -kuvauksen?

REST API v2 -rajapinnan OpenAPI-kuvaus on avoinna ilman kirjautumista osoitteessa /api/v2/openapi.json: lataa se mihin tahansa OpenAPI-yhteensopivaan työkaluun tai luo siitä asiakas. WŬMÙ-valtuutuspalvelimen metatiedot ovat osoitteessa /.well-known/openid-configuration.

Avaa OpenAPI-kuvaus
Rajoittaako WŬMÙ API pyyntöjen määrää?

Kyllä. REST API v2 rajoittaa jokaista sovelluksen ja käyttäjän paria: oletuksena 100 pyyntöä minuutissa, ja joillakin osioilla, kuten Pikaviestimellä, on oma rajansa. Rajan ylitys palauttaa tilakoodin 429 – yritä pyyntöä myöhemmin uudelleen. Myös MCP:n kautta yhdistetyllä tekoälyavustajalla on minuuttikohtainen pyyntöraja.

Miten WŬMÙ MCP -palvelin eroaa OAuth-sovelluksesta?

WŬMÙ MCP -palvelin on valmis yhteys tekoälyavustajille: mitään ei tarvitse rekisteröidä – liitä URL-osoite ja kirjaudu tililläsi. OAuth-sovellusta tarvitset, kun rakennat oman integraation: verkkosivuston, palvelun tai mobiilisovelluksen, joka kutsuu REST API v2 -rajapintaa käyttäjien puolesta.

Aloita integraatiosi

Kirjaudu WŬMÙ-palveluun, luo sovellus kehittäjäkonsolissa ja hanki avaimesi.