Ontwikkelaars
Koppel WŬMÙ aan je eigen systemen
WŬMÙ staat op drie manieren open voor integraties: apps melden zich aan via OAuth 2.0 met PKCE en werken met gegevens via de REST API v2 met OpenAPI-beschrijving, en AI-assistenten verbinden met de MCP-server via een URL.
Sleutels krijg je in de ontwikkelaarsconsole: log in bij WŬMÙ, maak een app aan en ontvang je client_id.
https://wumu.ai
- Autorisatie
- /api/oauth/authorize
- Tokens
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- MCP-server
- /mcp
Drie manieren om te koppelen
Kies hoe je koppelt
Je eigen app of dienst koppelt via OAuth en de REST API. Een AI-assistent koppelt via de MCP-server, zonder een app te registreren.
OAuth 2.0 met PKCE
Voor websites, diensten en mobiele apps die met toestemming van een WŬMÙ-gebruiker met diens gegevens werken.
- Autorisatiecode met PKCE (S256) en rotatie van refreshtokens; client_credentials voor server-naar-serververkeer
- De gebruiker ziet een toestemmingsscherm en geeft alleen de nodige rechten: profiel, documenten, chats, contacten en meer
- Publieke clients — mobiele apps en SPA’s — krijgen geen secret
- Webhooks ondertekend met HMAC-SHA256, plus een logboek van verzoeken en afleveringen in de ontwikkelaarsconsole
- Een nieuwe app gaat live nadat een WŬMÙ-beheerder hem heeft gecontroleerd
REST API v2
Een JSON-API voor documenten, spreadsheets, AI-chats, de messenger, contacten, de agenda en andere onderdelen van WŬMÙ.
- Machineleesbare OpenAPI-beschrijving die per operatie de benodigde rechten noemt
- Het toegangstoken gaat mee in de header Authorization: Bearer
- Een limiet op verzoeken per minuut voor elk paar van app en gebruiker; daarboven volgt het antwoord 429
MCP-server
Een AI-assistent verbindt via een URL met een WŬMÙ-account — zonder sleutels, zonder ontwikkelaarsapp en zonder installatie.
- Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in ontwikkelaarsmodus, Cursor en andere clients die externe MCP-servers met OAuth-aanmelding ondersteunen
- Je meldt je aan met je eigen account en kiest zelf de onderdelen; lezen en wijzigen zijn aparte schakelaars
- Onderdelen met gegevens van anderen — aanvragen, messenger, contacten — staan standaard uit
- Je kunt de assistent op elk moment ontkoppelen in de beveiligingsinstellingen van je account
Verbindings-URL
https://wumu.ai/mcpVoor een account op wumu.aihttps://wumu.ru/mcpVoor een account op wumu.ru (Rusland)
Voorbeeldverzoek
Je eerste verzoek
Haal via OAuth een toegangstoken op en geef het mee in de header: het eerste verzoek geeft je vijf nieuwste chats met de AI-jurist terug en vraagt het recht read:chats. Het tweede commando voegt de WŬMÙ-MCP-server toe aan Claude Code.
# je vijf nieuwste chats met de AI-jurist
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# de WŬMÙ-MCP-server toevoegen aan Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcpVragen van ontwikkelaars
Heb ik een betaald abonnement nodig voor de WŬMÙ-API?
Voor OAuth-apps en de REST API v2 is geen betaald abonnement nodig: je maakt een app aan op elk WŬMÙ-abonnement, ook het gratis abonnement. Een AI-assistent kun je ook met het gratis abonnement met de WŬMÙ-MCP-server verbinden, met toegang tot je profiel, je stadsconcepten en het helpcentrum; voor de overige onderdelen heb je een eigen Pro-abonnement of hoger nodig, en een Business-proefperiode telt ook.
Hoe krijg ik een WŬMÙ-API-sleutel?
Log in bij WŬMÙ en open de ontwikkelaarsconsole. Maak een app aan met een naam, redirect-URL’s en rechten. Je krijgt een client_id en een serverapp krijgt ook een client_secret — die wordt maar één keer getoond, dus bewaar hem goed. De app geeft tokens uit zodra een WŬMÙ-beheerder hem heeft gecontroleerd.
Waar vind ik de beschrijving van de WŬMÙ-REST-API?
De OpenAPI-beschrijving van de REST API v2 staat zonder aanmelding op /api/v2/openapi.json: laad hem in elke tool die OpenAPI begrijpt of genereer er een client mee. De metadata van de WŬMÙ-autorisatieserver staan op /.well-known/openid-configuration.
OpenAPI-beschrijving openenBeperkt de WŬMÙ-API het aantal verzoeken?
Ja. De REST API v2 beperkt elk paar van app en gebruiker: standaard 100 verzoeken per minuut, en sommige onderdelen, zoals de messenger, hebben een eigen limiet. Daarboven antwoordt de server met status 429 — probeer het later opnieuw. Ook een via MCP verbonden AI-assistent heeft een limiet per minuut.
Wat is het verschil tussen de WŬMÙ-MCP-server en een OAuth-app?
De WŬMÙ-MCP-server is een kant-en-klare koppeling voor AI-assistenten: er hoeft niets geregistreerd te worden, je plakt de URL en meldt je aan met je account. Een OAuth-app heb je nodig als je een eigen integratie bouwt: een website, dienst of mobiele app die namens gebruikers de REST API v2 aanroept.