เอกสารประกอบการใช้งาน API

การเชื่อมต่อและการใช้งานกับ Shifton API

The Shifton API ให้คุณเข้าถึงฟีเจอร์หลักทั้งหมดของแพลตฟอร์ม — ตั้งแต่การจัดการตารางการทำงานไปจนถึงการเชื่อมต่อกับ HR, payroll, และ ระบบวิเคราะห์ภายนอก.
โดยใช้ API คุณสามารถทำกระบวนการอัตโนมัติและเชื่อม Shifton กับบริการภายในของบริษัทของคุณได้

เอกสารประกอบ API

เราสนับสนุนเอกสารของเราในสองเวอร์ชัน:

• 📄 เอกสารเก่า — เวอร์ชันก่อนหน้านี้ของเอกสารอ้างอิง API (ยังคงรองรับสำหรับการรวมระบบที่มีอยู่):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 เอกสารใหม่ — เวอร์ชันปัจจุบันของ API ที่มีโครงสร้างที่อัพเดตและวิธีการล่าสุด:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

การเริ่มต้น

รับ API Key

ในตั้งค่าบริษัทของคุณบนแพลตฟอร์ม Shifton ให้สร้าง API key.
การอนุญาตทำผ่านส่วนหัว:

ทำการร้องขอครั้งแรกของคุณ

เช่น เพื่อดึงรายชื่อพนักงาน:

ตัวอย่างการตอบกลับ:

รวม API เข้ากับกระบวนการทำงานของคุณ

• สร้างและปรับเปลี่ยนกะการทำงานโดยอัตโนมัติ

• จัดการคำขอลาพักร้อนและลาป่วย

• ส่งออกข้อมูลไปยังระบบบัญชีเงินเดือน

• สร้างแท็บเล็ตและรายงานแบบกำหนดเอง

ความสามารถหลักของ API

• พนักงาน – เพิ่ม, แก้ไข, และจัดการบทบาท

• ตารางเวลา – สร้าง, ปรับเปลี่ยนกะงาน, วางแผนการทำงาน

• การลาหยุดและการขาดงาน – จัดการคำขอลาพักร้อนและลาป่วย

• การรายงาน – ส่งออกข้อมูลเวลา, เงินเดือน, และการเข้าทำงาน

รหัสข้อผิดพลาด

Shifton API ใช้รหัสสถานะ HTTP มาตรฐาน:

• 200 — คำขอสำเร็จ

• 201 — การสร้างวัตถุสำเร็จ

• 400 — พารามิเตอร์ไม่ถูกต้อง

• 401 — ข้อผิดพลาดในการอนุญาต (คีย์ API ไม่ถูกต้อง)

• 403 — การเข้าถึงถูกปฏิเสธ

• 404 — ไม่พบทรัพยากร

• 500 — ข้อผิดพลาดของเซิร์ฟเวอร์

เคล็ดลับการใช้งาน

• ควรใช้ เวอร์ชัน API ใหม่ สำหรับการผสานรวมใหม่

• ใช้ Postman หรือ curl สำหรับการทดสอบ

• เคารพ ข้อจำกัดของอัตรา เพื่อหลีกเลี่ยงการถูกบล็อก

• อัปเดตการเชื่อมต่อที่ยังคงใช้เอกสารเก่า