API สำหรับพาร์ทเนอร์
API ฝั่งเซิร์ฟเวอร์สำหรับพาร์ทเนอร์: สร้างลูกค้า มอบแพ็กเกจ และจัดการการสมัครสมาชิกจากเว็บไซต์หรือบอตของคุณเอง
API สำหรับพาร์ทเนอร์ช่วยให้คุณสร้างเว็บไซต์ พอร์ทัลลูกค้า หรือบอตของคุณเองบน CreateYourVPN ได้ API เปิดเผยเฉพาะลูกค้า แพ็กเกจ และการสมัครสมาชิกเท่านั้น เซิร์ฟเวอร์ โหนด แผงควบคุม และข้อมูลรับรองของโครงสร้างพื้นฐานจะไม่ปรากฏในคำตอบ
คีย์ใช้สำหรับการสื่อสารระหว่างเซิร์ฟเวอร์เท่านั้น อย่าใส่คีย์ใน JavaScript หรือแอปมือถือ คำขอที่ดูเหมือนมาจากเบราว์เซอร์จะถูกปฏิเสธด้วย 403 browser_forbidden
เริ่มต้นใช้งาน
- เปิด การตั้งค่า → API และการเชื่อมต่อ ในแดชบอร์ด
- สร้างคีย์ที่มีสิทธิ์ขั้นต่ำและคัดลอก secret ซึ่งจะแสดงเพียงครั้งเดียว
- ส่งคีย์เป็น
Authorization: Bearer cyv_live_…หรือX-API-Key
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"สิทธิ์ที่มี: config:read สำหรับการตั้งค่าและตำแหน่งที่ตั้ง, users:read สำหรับอ่านข้อมูลลูกค้า และ users:write สำหรับสร้างลูกค้าและจัดการการสมัครสมาชิก
สัญญาสาธารณะ
คอลเลกชัน Postman สาธารณะมี endpoint, พารามิเตอร์, body, ตัวอย่าง, สิทธิ์ และรหัสข้อผิดพลาดทั้งหมด คอลเลกชันสร้างจากสัญญาของ backend และเป็นข้อมูลอ้างอิงทางเทคนิคเพียงแห่งเดียว
ขีดจำกัด: 120 คำขอต่อนาทีต่อคีย์ และ 10 คำขอต่อนาทีสำหรับ GET /users คำสั่ง grant, rotate และ DELETE ต้องมี Idempotency-Key; ใช้ค่าเดิมซ้ำภายใน 24 ชั่วโมงสำหรับการลองใหม่ของเหตุการณ์เดียวกัน
กู้คืนจากข้อมูลสำรอง
สองวิธีในการนำผู้ใช้ของคุณกลับมา: การกู้คืนในแดชบอร์ดเพียงคลิกเดียวที่นำเข้าผู้ใช้ซ้ำได้แบบ idempotent หรือการกู้คืนด้วยตนเองเข้าสู่ Marzban เปล่า เพราะไฟล์อยู่ในรูปแบบผู้ใช้ Marzban ดั้งเดิม
การเข้าถึงฉุกเฉิน
วิธีเชื่อมต่อสำรองสำหรับตอนที่เครือข่ายใช้รายการอนุญาตและการเชื่อมต่อหลักถูกบล็อก — สร้างวิดีโอคอล ส่งลิงก์ของคอลให้เราจากบัญชีของคุณหรือทางอีเมล แล้วรับการเชื่อมต่อพร้อมใช้