นักพัฒนา

REST API ที่สร้างมาเพื่อข้อมูลสนามแบบหลายผู้เช่า

ยี่สิบสามจุดเชื่อมต่อแบบมีเวอร์ชันภายใต้ /api/v1 พร้อม Bearer auth สิทธิ์เฉพาะทาง การจำกัดอัตราต่อโทเคน และบันทึกตรวจสอบทุกการเรียก

การยืนยันตัวตน
# สร้างโทเค็นได้ที่ แดชบอร์ด → การเชื่อมต่อ
# รหัสลับจะแสดงเพียงครั้งเดียว และจัดเก็บเป็นแฮช SHA-256

curl https://kourtiva.com/api/v1/me \
  -H "Authorization: Bearer $KOURTIVA_TOKEN"

# 401 เมื่อโทเค็นไม่ถูกต้อง หมดอายุ หรือถูกเพิกถอน
# 403 เมื่อโทเค็นไม่มีสิทธิ์ที่จำเป็น
# 429 เมื่อเรียกใช้เกินขีดจำกัด
api.kourtiva.com GET/v1/courts/availability Authorization: Bearer kv_live_•••• 200OK · 34ms { "venue": "vn_8832a", "courts": [ { "id": "crt_01", "sport": "padel", "free": ["19:00", "21:00"] }, { "id": "crt_02", "sport": "tennis", "free": ["18:00"] } ] }

ความปลอดภัยที่ไม่ใช่ตัวเลือกเสริม

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

อ่านและเขียนอะไรได้บ้าง

การจอง

ดู ตรวจสอบ และกรองการจองในทุกคอร์ท รวมถึงสถานะเช็คอิน

คอร์ทและช่วงเวลา

ข้อมูลคอร์ทและช่วงเวลาที่จองได้ พร้อมสถานะว่างตามวันที่

กีฬาและสิ่งอำนวยความสะดวก

กีฬาที่คุณเปิดให้บริการ และสิ่งอำนวยความสะดวกของแต่ละสนาม

สมาชิก

ผู้เล่นที่ลงทะเบียนกับสนามของคุณ พร้อมประวัติการจอง

ใบแจ้งหนี้และการชำระเงิน

บันทึกทางการเงินที่ผูกกับการจองต้นทาง

ทัวร์นาเมนต์

การแข่งขัน ทีมที่ลงทะเบียน และโปรแกรมแข่ง

ผู้เข้าใช้

จำนวนผู้เข้าใช้และสรุปสำหรับรายงานอัตราการใช้งาน

โปรไฟล์สนาม

ข้อมูลสนามของคุณเอง — ผู้เช่าที่โทเคนอ้างถึง

มีระบบเวอร์ชัน คุณจึงกำหนดเวลาอัปเกรดเอง

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

ขอสิทธิ์เข้าใช้ API
คอร์ทที่ว่าง
GET /api/v1/courts/12/slots?date=2026-08-09

{
  "data": [
    { "starts_at": "08:00", "available": true  },
    { "starts_at": "09:00", "available": false },
    { "starts_at": "10:00", "available": true  }
  ]
}

ต้องการจุดเชื่อมต่อที่เรายังไม่มี?

บอกเราว่าคุณกำลังเชื่อมต่อกับอะไร แล้วเราจะดูให้

จองเดโมส่วนตัว