Nhà phát triển

Kết nối WŬMÙ với hệ thống của bạn

WŬMÙ mở cho tích hợp theo ba cách: ứng dụng đăng nhập bằng OAuth 2.0 với PKCE và làm việc với dữ liệu qua REST API v2 có mô tả OpenAPI, còn trợ lý AI kết nối với máy chủ MCP bằng một URL.

Khóa được cấp trong bảng điều khiển nhà phát triển: đăng nhập WŬMÙ, tạo ứng dụng và nhận client_id.

https://wumu.ai

Ủy quyền
/api/oauth/authorize
Token
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
Máy chủ MCP
/mcp

Ba cách kết nối

Chọn cách kết nối

Ứng dụng hoặc dịch vụ của bạn kết nối qua OAuth và REST API. Trợ lý AI kết nối qua máy chủ MCP, không cần đăng ký ứng dụng.

  • OAuth 2.0 với PKCE

    Dành cho trang web, dịch vụ và ứng dụng di động làm việc với dữ liệu của người dùng WŬMÙ khi được họ đồng ý.

    • Mã ủy quyền với PKCE (S256) và xoay vòng refresh token; client_credentials cho các lệnh gọi giữa máy chủ
    • Người dùng thấy màn hình đồng ý và chỉ cấp các quyền cần thiết: hồ sơ, tài liệu, trò chuyện, danh bạ và hơn thế
    • Ứng dụng khách công khai — ứng dụng di động và SPA — không được cấp secret
    • Webhook ký bằng HMAC-SHA256 cùng nhật ký yêu cầu và lần gửi trong bảng điều khiển nhà phát triển
    • Ứng dụng mới bắt đầu hoạt động sau khi quản trị viên WŬMÙ xem xét
  • REST API v2

    API JSON cho tài liệu, bảng tính, trò chuyện AI, messenger, danh bạ, lịch và các phần khác của WŬMÙ.

    • Mô tả OpenAPI máy đọc được, ghi rõ quyền mà mỗi thao tác cần
    • Token truy cập được gửi trong tiêu đề Authorization: Bearer
    • Giới hạn số yêu cầu mỗi phút cho từng cặp ứng dụng và người dùng; vượt quá sẽ nhận phản hồi 429
  • Máy chủ MCP

    Trợ lý AI kết nối với tài khoản WŬMÙ bằng một URL — không cần khóa, không cần ứng dụng nhà phát triển, không cần cài đặt.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT ở chế độ nhà phát triển, Cursor và các ứng dụng khách khác hỗ trợ máy chủ MCP từ xa với đăng nhập OAuth
    • Bạn đăng nhập bằng tài khoản của mình và tự chọn các phần; đọc và thay đổi là các công tắc riêng
    • Các phần chứa dữ liệu của người khác — yêu cầu, messenger, danh bạ — mặc định bị tắt
    • Bạn có thể ngắt kết nối trợ lý bất cứ lúc nào trong cài đặt bảo mật tài khoản

    URL kết nối

    • https://wumu.ai/mcpCho tài khoản trên wumu.ai
    • https://wumu.ru/mcpCho tài khoản trên wumu.ru (Nga)

Yêu cầu mẫu

Yêu cầu đầu tiên

Lấy token truy cập qua OAuth và gửi trong tiêu đề: yêu cầu đầu tiên trả về năm cuộc trò chuyện gần nhất của bạn với luật sư AI và cần quyền read:chats. Lệnh thứ hai thêm máy chủ MCP của WŬMÙ vào Claude Code.

# năm cuộc trò chuyện gần nhất với luật sư AI
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# thêm máy chủ MCP của WŬMÙ vào Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
Mọi thao tác đều có trong mô tả OpenAPI

Câu hỏi của nhà phát triển

Có cần gói trả phí để dùng API của WŬMÙ không?

Ứng dụng OAuth và REST API v2 không cần gói trả phí: bạn có thể tạo ứng dụng trên mọi gói WŬMÙ, kể cả gói miễn phí. Bạn cũng có thể kết nối trợ lý AI với máy chủ MCP của WŬMÙ trên gói miễn phí, với quyền truy cập hồ sơ, bản nháp trong thành phố và trung tâm trợ giúp; các mục còn lại cần gói Pro trở lên của riêng bạn, thời gian dùng thử Business cũng được tính.

Làm sao để lấy khóa API của WŬMÙ?

Đăng nhập WŬMÙ và mở bảng điều khiển nhà phát triển. Tạo ứng dụng với tên, URL chuyển hướng và quyền. Bạn nhận được client_id, còn ứng dụng phía máy chủ nhận thêm client_secret — nó chỉ hiển thị một lần, hãy lưu lại. Ứng dụng bắt đầu cấp token sau khi quản trị viên WŬMÙ xem xét.

Mô tả REST API của WŬMÙ ở đâu?

Mô tả OpenAPI của REST API v2 được mở công khai, không cần đăng nhập, tại /api/v2/openapi.json: hãy tải vào bất kỳ công cụ nào hiểu OpenAPI hoặc tạo ứng dụng khách từ đó. Siêu dữ liệu của máy chủ ủy quyền WŬMÙ ở /.well-known/openid-configuration.

Mở mô tả OpenAPI
API của WŬMÙ có giới hạn số yêu cầu không?

Có. REST API v2 giới hạn từng cặp ứng dụng và người dùng: mặc định 100 yêu cầu mỗi phút, và một số phần như messenger có giới hạn riêng. Khi vượt quá, máy chủ trả về trạng thái 429 — hãy thử lại sau. Trợ lý AI kết nối qua MCP cũng có giới hạn yêu cầu mỗi phút.

Máy chủ MCP của WŬMÙ khác ứng dụng OAuth thế nào?

Máy chủ MCP của WŬMÙ là kết nối có sẵn cho trợ lý AI: không cần đăng ký gì, chỉ cần dán URL và đăng nhập bằng tài khoản của bạn. Ứng dụng OAuth cần thiết khi bạn tự xây dựng tích hợp — trang web, dịch vụ hoặc ứng dụng di động gọi REST API v2 thay mặt người dùng.

Bắt đầu tích hợp

Đăng nhập WŬMÙ, tạo ứng dụng trong bảng điều khiển nhà phát triển và lấy khóa của bạn.