Geliştiriciler

WŬMÙ’yu kendi sistemlerinize bağlayın

WŬMÙ entegrasyonlara üç yolla açıktır: uygulamalar PKCE’li OAuth 2.0 ile oturum açar ve OpenAPI tanımlı REST API v2 üzerinden verilerle çalışır; yapay zekâ asistanları ise MCP sunucusuna bir URL ile bağlanır.

Anahtarlar geliştirici konsolunda verilir: WŬMÙ’ya giriş yapın, bir uygulama oluşturun ve client_id’nizi alın.

https://wumu.ai

Yetkilendirme
/api/oauth/authorize
Belirteçler
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP sunucusu
/mcp

Bağlanmanın üç yolu

Nasıl bağlanacağınızı seçin

Kendi uygulamanız veya hizmetiniz OAuth ve REST API üzerinden bağlanır. Bir yapay zekâ asistanı ise uygulama kaydı olmadan MCP sunucusu üzerinden bağlanır.

  • PKCE ile OAuth 2.0

    Bir WŬMÙ kullanıcısının verileriyle onun onayıyla çalışan web siteleri, hizmetler ve mobil uygulamalar için.

    • PKCE (S256) ile yetkilendirme kodu ve yenileme belirteci rotasyonu; sunucudan sunucuya çağrılar için client_credentials
    • Kullanıcı bir onay ekranı görür ve yalnızca gereken izinleri verir: profil, belgeler, sohbetler, kişiler ve daha fazlası
    • Açık istemcilere — mobil uygulamalar ve SPA’lar — gizli anahtar verilmez
    • HMAC-SHA256 ile imzalanan webhook’lar ve geliştirici konsolunda istek ve teslimat günlüğü
    • Yeni bir uygulama, bir WŬMÙ yöneticisi inceledikten sonra çalışmaya başlar
  • REST API v2

    Belgeler, tablolar, yapay zekâ sohbetleri, mesajlaşma, kişiler, takvim ve WŬMÙ’nun diğer bölümleri için bir JSON API.

    • Her işlemin gerektirdiği izinleri belirten, makinece okunabilir OpenAPI tanımı
    • Erişim belirteci Authorization: Bearer başlığında gönderilir
    • Her uygulama–kullanıcı çifti için dakika başına istek sınırı; aşılırsa yanıt 429 olur
  • MCP sunucusu

    Bir yapay zekâ asistanı bir WŬMÙ hesabına URL ile bağlanır — anahtar, geliştirici uygulaması ya da kurulum gerekmez.

    • Claude (claude.ai, Claude Desktop, Claude Code), geliştirici modundaki ChatGPT, Cursor ve uzak MCP sunucularını OAuth girişiyle destekleyen diğer istemciler
    • Kendi hesabınızla giriş yapar ve bölümleri kendiniz seçersiniz; okuma ve değiştirme ayrı anahtarlardır
    • Başka kişilerin verilerini içeren bölümler — talepler, mesajlaşma, kişiler — varsayılan olarak kapalıdır
    • Asistanın bağlantısını hesabınızın güvenlik ayarlarından istediğiniz zaman kesebilirsiniz

    Bağlantı URL’si

    • https://wumu.ai/mcpwumu.ai hesabı için
    • https://wumu.ru/mcpwumu.ru hesabı için (Rusya)

Örnek istek

İlk isteğiniz

OAuth ile bir erişim belirteci alın ve başlıkta gönderin: ilk istek, yapay zekâ avukatıyla son beş sohbetinizi döndürür ve read:chats iznini gerektirir. İkinci komut WŬMÙ MCP sunucusunu Claude Code’a ekler.

# yapay zekâ avukatıyla son beş sohbetiniz
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# WŬMÙ MCP sunucusunu Claude Code’a ekleyin
claude mcp add --transport http wumu https://wumu.ai/mcp
Tüm işlemler OpenAPI tanımında

Geliştirici soruları

WŬMÙ API’sini kullanmak için ücretli plan gerekir mi?

OAuth uygulamaları ve REST API v2 için ücretli plan gerekmez: uygulama, ücretsiz plan dahil her WŬMÙ planında oluşturulabilir. Bir yapay zekâ asistanı ücretsiz planda da WŬMÙ MCP sunucusuna bağlanabilir ve profilinize, şehir taslaklarınıza ve yardım merkezine erişebilir; diğer bölümler için kendi Pro veya üstü planınız gerekir, Business deneme süresi de geçerlidir.

WŬMÙ API anahtarını nasıl alırım?

WŬMÙ’ya giriş yapın ve geliştirici konsolunu açın. Ad, yönlendirme adresleri ve izinlerle bir uygulama oluşturun. Bir client_id alırsınız; sunucu tarafı uygulama ayrıca bir client_secret alır — yalnızca bir kez gösterilir, saklayın. Uygulama, bir WŬMÙ yöneticisi inceledikten sonra belirteç vermeye başlar.

WŬMÙ REST API tanımını nerede bulurum?

REST API v2’nin OpenAPI tanımı giriş yapmadan /api/v2/openapi.json adresinde açıktır: OpenAPI’yi anlayan herhangi bir araca yükleyebilir veya ondan istemci üretebilirsiniz. WŬMÙ yetkilendirme sunucusunun meta verileri /.well-known/openid-configuration adresindedir.

OpenAPI tanımını aç
WŬMÙ API’si istek sayısını sınırlar mı?

Evet. REST API v2 her uygulama–kullanıcı çiftini sınırlar: varsayılan olarak dakikada 100 istek; mesajlaşma gibi bazı bölümlerin kendi sınırı vardır. Sınır aşılırsa sunucu 429 durumuyla yanıt verir — isteği daha sonra yineleyin. MCP ile bağlı bir yapay zekâ asistanının da dakika başına istek sınırı vardır.

WŬMÙ MCP sunucusunun OAuth uygulamasından farkı nedir?

WŬMÙ MCP sunucusu, yapay zekâ asistanları için hazır bir bağlantıdır: hiçbir şey kaydetmeniz gerekmez, URL’yi yapıştırıp hesabınızla giriş yapmanız yeterlidir. OAuth uygulaması ise kendi entegrasyonunuzu yazarken gerekir: kullanıcılar adına REST API v2’yi çağıran bir web sitesi, hizmet veya mobil uygulama.

Entegrasyonunuza başlayın

WŬMÙ’ya giriş yapın, geliştirici konsolunda bir uygulama oluşturun ve anahtarınızı alın.