API และการเชื่อมระบบภายนอก

🔌 API และการเชื่อมระบบภายนอก

สร้างโทเคน จำกัดสิทธิ์และ IP แล้วสั่งงานแผงควบคุมจากระบบขายหรือสคริปต์ของคุณเอง

สร้างโทเคน

เปิด API เลื่อนลงมาที่ฟอร์มสร้างโทเคน ตั้งชื่อให้รู้ว่าใครใช้

เลือกสิทธิ์ (scope) ให้แคบที่สุดเท่าที่พอใช้ หรือติ๊ก “เข้าถึงทั้งหมด” ถ้าจำเป็นจริง ๆ

ใส่ IP ที่อนุญาต (รองรับ CIDR) ถ้าเว้นว่าง = เรียกได้จากทุก IP

กดสร้าง แล้วคัดลอกโทเคนเก็บไว้ — ปฏิบัติกับมันเหมือนรหัสผ่าน

กลุ่ม	สิทธิ์ในกลุ่ม
🌐 เว็บไซต์ `sites:*`	`sites:read` — ดูรายชื่อเว็บ รายละเอียด และแบนด์วิดท์ `sites:write` — สร้างเว็บไซต์ใหม่ `sites:delete` — ลบเว็บไซต์ (รวม ?purge=1 ที่ลบไฟล์และฐานข้อมูลด้วย) `sites:php` — เปลี่ยนเวอร์ชัน PHP ของเว็บ `sites:wordpress` — ติดตั้ง WordPress ลงเว็บ `sites:suspend` — ระงับ / ปลดระงับเว็บ
📁 ไฟล์ `files:*`	`files:write` — อัปโหลดไฟล์เข้าเว็บ และแตกไฟล์ .zip `files:link` — ออกลิงก์เข้าตัวจัดการไฟล์แบบใช้ครั้งเดียว
🗄 ฐานข้อมูล `db:*`	`db:read` — ดูรายการฐานข้อมูลของเว็บ (ไม่รวมรหัสผ่าน) `db:write` — สร้างฐานข้อมูลใหม่ให้เว็บ `db:import` — นำเข้าไฟล์ dump ทับฐานข้อมูล `db:link` — ออกลิงก์เข้า phpMyAdmin แบบใช้ครั้งเดียว
👥 สมาชิก `members:*`	`members:read` — ดูรายชื่อสมาชิก ข้อมูล และการใช้งานของแต่ละคน `members:write` — สร้างบัญชีสมาชิกใหม่ `members:password` — ตั้งรหัสผ่านเข้าแผงควบคุมให้สมาชิก `members:plan` — ย้ายแพ็กเกจของสมาชิก (อัปเกรด/ดาวน์เกรด) `members:suspend` — ระงับ / ปลดระงับบัญชีสมาชิก `members:ssh` — เปิด/ปิดสิทธิ์ SSH ของสมาชิก `members:delete` — ลบบัญชีสมาชิก (รวม ?purge=1 ที่ลบเว็บทั้งหมดของเขา)
🔑 ลิงก์ล็อกอิน & เปิดบริการ `access:*`	`sso` — ออกลิงก์ล็อกอินเข้าแผงควบคุมแทนผู้ใช้ (ใช้ครั้งเดียว อายุ 120 วิ) `provision` — เปิดบริการครบชุดในคำสั่งเดียว: สมาชิก + เว็บ + WordPress + โซน DNS + ลิงก์เข้าใช้งาน
📦 แพ็กเกจ `plans:*`	`plans:read` — ดูแพ็กเกจที่ขายได้ `plans:write` — สร้างและแก้ไขแพ็กเกจ `plans:delete` — ลบแพ็กเกจ
📊 เซิร์ฟเวอร์ & Cron `monitor:*`	`server:read` — อ่านสถิติของเซิร์ฟเวอร์ `cron:read` — อ่านรายการ cronjob

💡 สิทธิ์แบ่งเป็น "การกระทำต่อกลุ่ม" เช่น sites:read อ่านได้อย่างเดียว ส่วน sites:* คือทั้งกลุ่ม · โทเคนเก่าที่ใช้ชื่อ sites, members, plans, server, cron ยังใช้ได้เหมือนเดิม ไม่ต้องออกใหม่

เรียกใช้งาน

ทุกคำขอส่งโทเคนมาในหัวข้อ Authorization: Bearer … ฐาน URL คือ https://host-th-sv1.f4host.com/api/v1

curl -H "Authorization: Bearer f4_xxxxxxxx" \ https://host-th-sv1.f4host.com/api/v1/sites # ทดสอบได้โดยไม่เปลี่ยนอะไรจริง — sandbox / dry-run: curl -H "Authorization: Bearer f4_xxxxxxxx" \ https://host-th-sv1.f4host.com/api/sandbox/v1/sites

💡 เส้นทาง /api/sandbox/v1/… ตรวจสิทธิ์และรูปแบบข้อมูลให้ครบเหมือนของจริง แต่ไม่เปลี่ยนแปลงอะไรบนเซิร์ฟเวอร์ เหมาะกับตอนพัฒนา

ลิงก์ล็อกอินอัตโนมัติ (SSO)

ระบบขายของคุณเรียก POST /api/v1/sso เพื่อขอลิงก์ล็อกอินแบบใช้ครั้งเดียวให้ลูกค้า ลูกค้ากดจากเว็บคุณแล้วเข้าแผงควบคุมได้เลย ไม่ต้องจำรหัสผ่านอีกชุด แนบปลายทางได้ด้วย เช่นให้เด้งเข้าหน้าไฟล์ของเว็บนั้นตรง ๆ

ดูรายการ endpoint ทั้งหมดพร้อมตัวอย่าง →

← ก่อนหน้า⏰ Cronjob — งานตามเวลา ถัดไป →👤 บัญชีและความปลอดภัย

ทุกหัวข้อในคู่มือ

🚀 เริ่มต้นใช้งานแผงควบคุม 🌐 สร้างและจัดการเว็บไซต์🛰 ชี้ DNS เข้ามาที่เซิร์ฟเวอร์🔒 SSL / HTTPS และใบรับรอง 🌿 ซับโดเมน & โดเมนเพิ่มเติม 📁 ตัวจัดการไฟล์ & ตัวแก้ไขโค้ด 📡 FTP / FTPS 🖥 SSH / SFTP และเว็บเทอร์มินัล 🐙 ดีพลอยด้วย Git 🗄 ฐานข้อมูล 🧩 ศูนย์ติดตั้งแอป ⏰ Cronjob — งานตามเวลา 🔌 API และการเชื่อมระบบภายนอก 👤 บัญชีและความปลอดภัย 🧯 แก้ปัญหาที่เจอบ่อย