Noxyr giờ cung cấp một REST API miễn phí, dành riêng cho từng máy chủ, để bạn lấy dữ liệu Discord trực tiếp: số thành viên, phân tích ticket, chỉ số hoạt động, doanh thu, đánh giá và giveaway, đưa vào website, bảng điều khiển, ứng dụng di động hoặc một bot khác. Mỗi máy chủ có một khóa riêng, được tạo từ bảng điều khiển, bảo mật bằng băm SHA-256 và được kiểm soát bởi các công tắc phạm vi do bạn quản lý.
Vì sao cần API theo phạm vi máy chủ?
Hầu hết bot Discord hoặc không cung cấp dữ liệu nào, hoặc bắt bạn phải tự xử lý API Discord thô với intent, kết nối gateway và tính toán giới hạn tốc độ. Noxyr Server API thì ngược lại: gửi một header, nhận về JSON. Sáu endpoint trả lời những câu hỏi mà chủ máy chủ thực sự hay hỏi: có bao nhiêu thành viên, tuần này có bao nhiêu ticket, doanh thu theo từng loại tiền tệ, điểm đánh giá trung bình, các giveaway đang chạy và xu hướng hoạt động hằng ngày.
Những gì bạn có thể đọc hiện tại
GET /api/v1/server: tên máy chủ, URL biểu tượng, số thành viên trực tiếp, số người đang online, số lượt boost, ngày tạo.GET /api/v1/tickets: tổng số / đang mở / đã đóng, số ticket mở trong 7 và 30 ngày qua, số đóng trong 7 ngày qua, điểm đánh giá trung bình và số lượt đánh giá.GET /api/v1/activity?days=30: tin nhắn, lượt tham gia và lượt rời đi theo ngày, tối đa 90 ngày, điền số 0 cho mọi ngày để không ngày nào bị thiếu.GET /api/v1/invoices: số lượng hóa đơn, khối lượng và doanh thu trong 7 / 30 ngày theo từng loại tiền tệ, cùng bảng phân tích trạng thái thanh toán.GET /api/v1/reviews: tổng số đánh giá đã đăng, điểm trung bình, bảng phân bố từ 1 đến 5 sao và 5 đánh giá mới nhất (sản phẩm, điểm, nội dung ngắn, tác giả).GET /api/v1/giveaways: số giveaway đang chạy / đã kết thúc, tổng số lượt tham gia và 5 giveaway đang chạy sẽ kết thúc sớm nhất.
Mô hình bảo mật
Khóa bắt đầu bằng nxr_ và có 192 bit entropy. Máy chủ chỉ lưu bản băm SHA-256, khóa gốc được hiển thị một lần khi tạo và không thể khôi phục. Mọi phản hồi đều phải qua hai bước kiểm tra: khóa có đang bật không, và phạm vi của endpoint này có được bật không? Tắt một phạm vi sẽ trả về 403 ngay lập tức; tắt hoặc thu hồi một khóa sẽ chặn mọi quyền truy cập mà không cần triển khai lại. Giới hạn tốc độ tính theo từng khóa, 60 yêu cầu mỗi phút.
Bắt đầu (60 giây)
- 1. Mở bảng điều khiển, chọn máy chủ của bạn và vào API Access.
- 2. Bấm Generate API Key và sao chép giá trị; đây là lần duy nhất khóa được hiển thị.
- 3. Bật hoặc tắt các phạm vi. Mỗi phạm vi có công tắc riêng.
- 4. Gọi
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"và bạn đã hoạt động.
Các tích hợp phổ biến
Hiển thị bộ đếm thành viên trực tiếp trên trang đích. Đăng bản tóm tắt ticket hằng tuần vào kênh nhân viên riêng tư. Xây dựng bảng xếp hạng công khai về mức độ tham gia giveaway. Đưa dữ liệu doanh thu vào bảng tính hoặc bảng quản trị riêng của bạn. Vì phản hồi là JSON thuần và có CORS dễ dãi, bạn có thể gọi API từ trình duyệt mà không cần proxy.
Tiếp theo là gì
Đọc thêm: API Discord so với Noxyr Server API, hướng dẫn từng bước, các nguyên tắc thiết kế đằng sau những endpoint này và cách chúng tôi xử lý lỗi API Discord.