XongNgay

Kết nối API XongNgay cho đại lý và cộng tác viên

Đại lý và cộng tác viên có thể đặt đơn bằng API: tạo API key tại trang Tài khoản, gửi key trong header X-Api-Key, lấy danh mục dịch vụ rồi gọi endpoint tạo đơn. Tài liệu đầy đủ với ví dụ lệnh cURL nằm ở trang Tài liệu API (/api-docs) sau khi đăng nhập.

API dành cho ai?

API phù hợp khi bạn muốn tích hợp việc đặt đơn vào công cụ hoặc hệ thống riêng thay vì nhập tay trên website, ví dụ đại lý quản lý nhiều đơn mỗi ngày. Người dùng bình thường không cần API: mọi thao tác đều có sẵn trên giao diện web.

Các bước kết nối

  1. Đăng nhập và mở trang Tài khoản

    Trang Tài khoản có mục API key hiển thị trạng thái key của bạn.

  2. Tạo API key mới

    Bấm tạo key và xác nhận. Key chỉ hiện một lần khi tạo; hãy lưu ngay ở nơi an toàn. Tạo key mới sẽ làm key cũ mất hiệu lực.

  3. Gửi key trong header X-Api-Key

    Mọi endpoint dạng /api/me cần xác thực bằng JWT sau khi đăng nhập hoặc bằng API key trong header X-Api-Key. Tài liệu khuyến nghị dùng API key cho tích hợp.

  4. Lấy danh mục dịch vụ

    Gọi endpoint danh mục dịch vụ để lấy ID số của dịch vụ và máy chủ trên xongngay.net.

  5. Tạo đơn

    Gọi endpoint tạo đơn với service_id, server_id, target_link và quantity. Đơn mắt livestream cần thêm duration_minutes; đơn bình luận cần comments, mỗi dòng một nội dung.

Các nhóm endpoint chính

Danh mục dịch vụ

Lấy danh mục, danh sách dịch vụ và chi tiết một dịch vụ theo slug. Khi có xác thực, giá hiển thị theo cấp thành viên của bạn.

Đơn hàng

Tạo một đơn, tạo nhanh nhiều đơn độc lập với tối đa 20 link, xem lịch sử đơn và chi tiết một đơn.

Ví và nạp tiền

Xem số dư ví, sổ giao dịch và lấy thông tin chuyển khoản để nạp tiền.

Tài khoản và API key

Xem thông tin tài khoản, trạng thái API key và tạo key mới.

Lưu ý khi dùng API

  • server_id là ID số trên xongngay.net, lấy từ endpoint danh mục, không dùng mã của hệ thống bên thứ ba.
  • Số tiền được trừ vào số dư ví khi tạo đơn và hoàn lại nếu đơn thất bại ở phía nhà cung cấp.
  • Theo trang Tài liệu API, giới hạn mặc định khoảng 60 yêu cầu mỗi phút với API key, nên hãy phân bổ lệnh và tránh gọi dồn dập.
  • Giữ bí mật API key: không dán vào mã nguồn công khai, ảnh chụp màn hình hay tin nhắn.

Bắt đầu ngay

Chưa có tài khoản thì đăng ký trước, rồi làm theo hướng dẫn trên website. Cần hỏi thêm, bạn có thể liên hệ hỗ trợ qua Zalo.

Đăng ký tài khoảnXem trang Tài khoảnĐăng nhập