HELPER VPS

VPS API: ทำคลาวด์เซิร์ฟเวอร์ให้อัตโนมัติด้วย JSON REST

API คลาวด์เซิร์ฟเวอร์ที่จัดการด้วยโค้ดตั้งแต่สร้างจนถึงลบเซิร์ฟเวอร์

  • JSON REST API
  • ยืนยันตัวตนด้วยคีย์ API (Bearer)
  • 300 คำขอต่อนาที

VPS API คือวิธีการโปรแกรมเพื่อทำงานที่คุณจะทำในแผงควบคุม เช่น การสร้าง การเริ่ม การหยุด และการลบเซิร์ฟเวอร์ ด้วยคำขอ HTTP API คลาวด์เซิร์ฟเวอร์ของ HELPER VPS ฟรีสำหรับสมาชิกทุกคน หลังจากชำระเงินครั้งแรก สร้างคีย์ API และเชื่อมต่อได้ทันที

  • REST API

    สมาชิกทุกคน

    ฟรี

    เรียกเก็บเงินรายเดือน

    • JSON REST
    • คีย์ API (Bearer)
    • 300 ครั้งต่อนาที
    • ฟรี
    เริ่มต้นใช้งาน

หากต้องการดูตัวอย่างคำขอและรูปแบบการตอบกลับทันที เอกสาร API

VPS API ทำอะไรให้อัตโนมัติได้บ้าง

VPS API แสดงพลังมากที่สุดเมื่อสร้างและลบเซิร์ฟเวอร์บ่อย หรือจัดการหลายเซิร์ฟเวอร์พร้อมกัน สรุประบบอัตโนมัติที่นิยมสี่แบบไว้แล้ว

แผงควบคุมกับ VPS API ใช้อะไรเมื่อไร

แผงควบคุมและ API ทำงานกับบัญชีเดียวกันและเซิร์ฟเวอร์เดียวกัน สำหรับการจัดการหนึ่งหรือสองเซิร์ฟเวอร์ด้วยมือ แผงควบคุมสะดวก สำหรับงานซ้ำ ๆ หรือเซิร์ฟเวอร์จำนวนมาก API จะเร็วกว่า

แผงควบคุม

จัดการด้วยการกดบนหน้าจอ

เหมาะสำหรับ

  • กรณีสร้างเซิร์ฟเวอร์ครั้งแรก
  • เมื่อจัดการเซิร์ฟเวอร์หนึ่งหรือสองเครื่องด้วยตัวเอง
  • ติดตั้งระบบปฏิบัติการใหม่และลงทะเบียนคีย์ SSH
  • เมื่อต้องดูรหัสผ่าน root อีกครั้ง

VPS API

จัดการด้วยการส่งคำขอจากโค้ด

เหมาะสำหรับ

  • สภาพแวดล้อมทดสอบที่สร้างและลบเซิร์ฟเวอร์บ่อย
  • deploy pipeline และระบบอัตโนมัติด้วยสคริปต์
  • เมื่ออ่านสถานะหลายเซิร์ฟเวอร์พร้อมกัน
  • เมื่อเชื่อมกับหน้าจัดการหรือบอทที่สร้างเอง

เชื่อมต่อ API คลาวด์เซิร์ฟเวอร์อย่างไร

มีสามขั้นตอน แรก ชำระเงินครั้งแรก และเมื่อยืนยันแล้ว สร้างคีย์ในหน้าคีย์ API ถัดมา ใส่คีย์ในส่วนหัว Authorization ของทุกคำขอโดยใช้รูปแบบ Bearer สุดท้าย ส่งคำขอไปยังพาธที่คุณต้องการหลังจากที่อยู่หลัก https://helpervps.com/api/v1 และผลลัพธ์จะกลับมาเป็น JSON

เริ่มต้นควรเรียก GET /catalog ก่อน จะได้ประเภทและขนาดเซิร์ฟเวอร์ที่เลือกได้ตอนนี้ รหัสภูมิภาค รหัสระบบปฏิบัติการและแอปคลิกเดียว และราคาแบ็กอัปอัตโนมัติ ดิสก์เสริม และการป้องกัน DDoS ในครั้งเดียว ใส่รหัส plan, location, image ที่ได้จากที่นี่ลงในคำขอสร้างเซิร์ฟเวอร์ได้เลย

เพื่อสร้างเซิร์ฟเวอร์ ส่งค่า plan, location, image และ label เป็น JSON ไปยัง POST /servers คุณยังสามารถรวม ID ของคีย์ SSH ที่คุณเพิ่มและตัวเลือก backups, extra_disk_gb และ ddos_protection ได้ คุณชำระสำหรับช่วงเวลาที่เลือกล่วงหน้า และการตอบกลับจะมี ID เซิร์ฟเวอร์ สถานะ และรหัสผ่าน root ดังนั้นควรบันทึกไว้ในที่ปลอดภัยทันที

ทำอะไรได้บ้างด้วย VPS API

VPS API จัดการวงจรชีวิตของเซิร์ฟเวอร์ตั้งแต่ต้นจนจบ อ่านรายการขายด้วย GET /catalog สร้างเซิร์ฟเวอร์ด้วย POST /servers อ่านรายการเซิร์ฟเวอร์ของคุณด้วย GET /servers และอ่านข้อมูลเซิร์ฟเวอร์หนึ่งเครื่องด้วย GET /servers/{id} การตอบกลับมีชื่อเซิร์ฟเวอร์ สถานะ ที่อยู่ IPv4 และ IPv6 ค่าบริการรายเดือน ตัวเลือกที่เลือก และวันชำระถัดไป

การเปิดปิดใช้คำขอ POST /servers/{id}/start, stop, reboot เพื่อเปิด ปิด และรีสตาร์ต POST /servers/{id}/renew ชำระค่าบริการหนึ่งเดือนทันทีเพื่อต่ออายุโดยไม่ต้องรอวันชำระ และ DELETE /servers/{id} ลบเซิร์ฟเวอร์ หากคำขอไม่ตรงกับสถานะปัจจุบันของเซิร์ฟเวอร์ จะแจ้งด้วยรหัส wrong_state สคริปต์จึงตัดสินใจขั้นต่อไปได้ง่าย

ข้อผิดพลาดจะกลับมาเป็น JSON ที่มีค่า error พร้อมรหัสสถานะ เหตุผลแยกเป็นรหัส เช่น คีย์ไม่ถูกต้องเป็น unauthorized ยอดคงเหลือไม่พอเป็น not_enough_balance จำนวนเซิร์ฟเวอร์ของบัญชีถึงขีดจำกัดเป็น limit และคำขอมากเกินไปเป็น rate_limited จึงจัดการตามสถานการณ์ในโปรแกรมได้ง่าย รายการทั้งหมดและตัวอย่างการตอบกลับสรุปไว้ในเอกสาร API

VPS API ราคาเท่าไร

VPS API ฟรีสำหรับสมาชิกทุกคน เซิร์ฟเวอร์และตัวเลือกที่สร้างด้วย API จะชำระในราคาเดียวกับเซิร์ฟเวอร์ที่สร้างในแผงควบคุม

HELPER VPS ในตัวเลข

เลือกจาก 40 ภูมิภาค 12 ระบบปฏิบัติการ และ 10 แอปคลิกเดียวในบัญชีเดียว และชำระเงินทันที ตัวเลขด้านล่างอิงตามสิ่งที่กำลังขายอยู่ในปัจจุบัน

เครื่องมืออัตโนมัติที่ใช้คู่กับ VPS API

เครื่องมือใดก็ตามที่ส่งคำขอ HTTP ได้ก็เชื่อมกับ VPS API ได้ ตั้งแต่ curl บรรทัดเดียว สคริปต์ Python, Node.js ไปจนถึง deploy pipeline ใช้ด้วยวิธีเดียวกัน

  • Terraform
  • Python
  • Node.js
  • GitLab CI
  • Docker

เหตุผลที่เลือก HELPER VPS API

คำถามที่พบบ่อยเรื่อง VPS API

คำตอบเรื่องการเชื่อมต่อ การยืนยันตัวตน และขีดจำกัดคำขอของ VPS API

VPS API ฟรีหรือไม่

ใช่ VPS API ฟรีสำหรับสมาชิกทุกคน การออกคีย์ API และการส่งคำขอฟรี ส่วนเซิร์ฟเวอร์และตัวเลือกที่สร้างด้วย API ชำระในราคาเดียวกับที่สร้างในแผงควบคุม สมาชิกที่ชำระเงินครั้งแรกแล้วสามารถสร้างคีย์ได้ทันทีในหน้าคีย์ API

สร้างคีย์ API ได้ที่ไหน

เมื่อคุณชำระเงินครั้งแรกเสร็จสิ้น หน้าคีย์ API (/api-key) จะเปิดและคุณสามารถสร้างคีย์ได้ที่นั่น ใส่คีย์ในส่วนหัว Authorization ของทุกคำขอโดยใช้รูปแบบ Bearer คีย์นี้เปิดใช้งานบัญชีของคุณทั้งหมด ดังนั้นอย่าเก็บไว้ในคลังโค้ด ให้เก็บไว้ในตัวแปรสภาพแวดล้อมหรือที่เก็บค่าลับ

ทำอะไรได้บ้างด้วย API

อ่านรายการขาย (GET /catalog) อ่านรายการเซิร์ฟเวอร์และข้อมูลเซิร์ฟเวอร์หนึ่งเครื่อง (GET /servers, GET /servers/{id}) สร้างเซิร์ฟเวอร์ (POST /servers) เปิด ปิด และรีสตาร์ต (start, stop, reboot) ต่ออายุหนึ่งเดือน (renew) และลบ (DELETE /servers/{id}) ตัวอย่างคำขอและรูปแบบการตอบกลับอยู่ในเอกสาร API

ขีดจำกัดคำขอเท่าไร

คีย์เดียวส่งคำขอได้สูงสุด 300 ครั้งต่อนาที หากเกินขีดจำกัดจะได้รหัสสถานะ 429 และข้อผิดพลาด rate_limited จึงจัดการในสคริปต์ให้รอสักครู่แล้วส่งใหม่ ระบบอัตโนมัติประจำวันอย่างการดูรายการเซิร์ฟเวอร์และการจัดการเปิดปิดทำงานได้สบายภายในขีดจำกัดนี้ และไม่มีค่าใช้จ่ายตามจำนวนคำขอ

สร้างเซิร์ฟเวอร์ด้วย API แล้วตัดค่าบริการอย่างไร

เมื่อคำขอ POST /servers สำเร็จ การชำระเงินสำหรับช่วงเวลาที่เลือกจะดำเนินการและเซิร์ฟเวอร์จะถูกสร้างขึ้น การชำระเงินสำหรับเซิร์ฟเวอร์ที่สร้างไม่สำเร็จจะคืนเข้าบัญชีเครดิตของคุณ

รับรหัสผ่าน root ผ่าน API อย่างไร

การตอบกลับของคำขอสร้างเซิร์ฟเวอร์จะมีค่า root_password หนึ่งครั้ง บันทึกไว้ในที่ปลอดภัยทันทีที่ได้รับ ดูซ้ำในแผงควบคุมได้ 7 วัน และหากส่งหมายเลขคีย์ SSH ไปด้วย ก็เชื่อมต่อด้วยคีย์ได้ทันทีโดยไม่ใช้รหัสผ่าน เริ่มเชื่อมต่อ SSH ได้ทันทีด้วยค่า ipv4 ในการตอบกลับ จึงต่อกับสคริปต์ deploy ได้ดี

ใส่คีย์ SSH ผ่าน API ได้หรือไม่

ได้ ใส่หมายเลขคีย์ SSH ที่ลงทะเบียนไว้เป็นค่า ssh_key_id ในคำขอสร้างเซิร์ฟเวอร์ คีย์นั้นจะถูกใส่ในเซิร์ฟเวอร์ใหม่ ลงทะเบียนคีย์ครั้งเดียวในหน้าคีย์ SSH ของแผงควบคุม และลายนิ้วมือแสดงแบบเดียวกับ ssh-keygen จึงรู้ได้ทันทีว่าเป็นคีย์ไหน กำหนดหมายเลขคีย์ครั้งเดียวแล้วใช้ซ้ำได้

ใช้กับภาษาหรือเครื่องมืออะไรได้บ้าง

หากส่งคำขอ HTTP ได้ ใช้ได้ทุกภาษาและเครื่องมือ ทดสอบด้วย curl ได้ทันที และเรียกด้วยที่อยู่และส่วนหัวเดียวกันจาก requests ของ Python, fetch ของ Node.js, ขั้นตอนสคริปต์ของ GitLab CI และฟีเจอร์คำขอ HTTP ของ Terraform การตอบกลับเป็น JSON ทั้งหมด จึงอ่านผลได้ง่าย

เมื่อเกิดข้อผิดพลาดจะรู้ได้อย่างไร

ข้อผิดพลาดจะกลับมาเป็น JSON ที่มีค่า error พร้อมรหัสสถานะที่ไม่ใช่ 2xx เหตุผลแยกไว้ เช่น คีย์ผิดเป็น unauthorized ขาดค่าเป็น bad_request ยอดคงเหลือไม่พอเป็น not_enough_balance และคำขอที่ไม่ตรงกับสถานะเซิร์ฟเวอร์เป็น wrong_state จึงจัดการตามสถานการณ์ในโปรแกรมได้

เซิร์ฟเวอร์ที่สร้างด้วย API แสดงในแผงควบคุมด้วยหรือไม่

ใช่ API และแผงควบคุมจัดการบัญชีเดียวกันและเซิร์ฟเวอร์เดียวกัน เซิร์ฟเวอร์ที่สร้างด้วย API แสดงในรายการของแผงควบคุมตามเดิม และติดตั้งระบบปฏิบัติการใหม่หรือดูรหัสผ่านในแผงควบคุมได้ ขีดจำกัด 10 เซิร์ฟเวอร์ต่อบัญชีใช้กับทั้งสองวิธีร่วมกัน แม้ผสมงานที่ทำด้วยมือกับงานที่ทำด้วยโค้ด สถานะและวันชำระก็แสดงตรงกันเสมอ

คู่มือ VPS API

คู่มือที่ควรอ่านเมื่อเชื่อมต่อ API ครั้งแรก

VPS API ฟรีสำหรับสมาชิกทุกคน และคุณสามารถสร้างคีย์ API ได้หลังจากชำระเงินครั้งแรก เซิร์ฟเวอร์และตัวเลือกที่สร้างด้วย API ชำระในราคาเดียวกับราคาในรายการและต่ออายุอัตโนมัติในจำนวนเดียวกันทุกวันที่ชำระเงิน

ขีดจำกัดคำขอ: 300 ครั้งต่อนาทีต่อคีย์ API | 10 เซิร์ฟเวอร์ต่อบัญชี | หากการชำระเงินล้มเหลว: เซิร์ฟเวอร์จะถูกระงับ แล้วลบหลังจาก 3 วัน | ไม่คืนเงินสำหรับช่วงเวลาที่เหลือของเซิร์ฟเวอร์ที่ลบ การคืนเงินจะเข้าบัญชีเครดิตของคุณ