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.ai
    • https://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/mcp
Alle operaties staan in de OpenAPI-beschrijving

Vragen 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 openen
Beperkt 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.

Begin met je integratie

Log in bij WŬMÙ, maak een app aan in de ontwikkelaarsconsole en ontvang je sleutel.