API Đối tác
API máy chủ dành cho đối tác: tạo khách hàng, cấp gói và quản lý đăng ký từ trang web hoặc bot của riêng bạn.
API Đối tác cho phép bạn xây dựng trang web, cổng khách hàng hoặc bot riêng trên CreateYourVPN. API chỉ cung cấp dữ liệu về khách hàng, gói và đăng ký; máy chủ, node, bảng điều khiển và thông tin xác thực hạ tầng không bao giờ xuất hiện trong phản hồi.
Khóa chỉ dành cho giao tiếp máy chủ với máy chủ. Không đặt khóa trong JavaScript hoặc ứng dụng di động. Yêu cầu có vẻ xuất phát từ trình duyệt sẽ bị từ chối với 403 browser_forbidden.
Bắt đầu
- Mở Cài đặt → API và tích hợp trong bảng điều khiển.
- Tạo khóa với quyền tối thiểu và sao chép phần bí mật; nó chỉ được hiển thị một lần.
- Gửi khóa dưới dạng
Authorization: Bearer cyv_live_…hoặcX-API-Key.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"Quyền: config:read cho cấu hình và vị trí, users:read để đọc khách hàng và users:write để tạo khách hàng và quản lý đăng ký.
Hợp đồng công khai
Bộ sưu tập Postman công khai chứa mọi endpoint, tham số, body, ví dụ, quyền và mã lỗi. Bộ sưu tập được tạo từ hợp đồng backend và là tài liệu kỹ thuật duy nhất.
Giới hạn: 120 yêu cầu mỗi phút cho mỗi khóa và 10 yêu cầu mỗi phút cho GET /users. grant, rotate và DELETE yêu cầu Idempotency-Key; hãy dùng lại cùng một giá trị trong 24 giờ cho mọi lần thử lại của cùng một sự kiện.
Khôi phục từ một bản sao lưu
Hai cách để đưa người dùng của bạn trở lại: khôi phục một cú nhấp trong bảng điều khiển giúp nhập lại họ một cách idempotent, hoặc khôi phục thủ công vào một Marzban trống vì tệp ở định dạng người dùng Marzban gốc.
Truy cập khẩn cấp
Cách kết nối dự phòng khi mạng dùng danh sách cho phép và kết nối chính bị chặn — bạn tạo một cuộc gọi video, đưa liên kết của nó cho chúng tôi từ tài khoản hoặc qua email, rồi nhận về một kết nối sẵn sàng dùng.