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.aihttps://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/mcpCâ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ả OpenAPIAPI 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.