Telesto API

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

ข้อกำหนดเบื้องต้น: จำเป็นต้องมีการสมัครสมาชิก Pro และ API key ที่ถูกต้องสำหรับ endpoint ทั้งหมด

การตรวจสอบสิทธิ์

การร้องขอ API ทั้งหมดต้องมีการตรวจสอบสิทธิ์โดยใช้ API key ของคุณใน Authorization header:

Base URL

ขด จำกัดการใช้งาน

• 100 คำขอต่อชั่วโมง ต่อที่อยู่ IP
• หมดเวลา 15 นาที หากเกินขีดจำกัดการใช้งาน
• คำขอทั้งหมดต้องมี API key ใน Authorization header

การเกินขีดจำกัดการใช้งานจะส่งผลให้ที่อยู่ IP ของคุณถูกบล็อกชั่วคราว 15 นาที

รูปแบบการตอบกลับ

การตอบกลับทั้งหมดจะถูกส่งคืนในรูปแบบ JSON ฟิลด์ที่ว่างเปล่าหรือ null จะถูกส่งคืนเป็นสตริงว่างเพื่อความสม่ำเสมอ

การตอบกลับที่สำเร็จ

{
    "id": "abc123...",
    "name": "My Product",
    "created": "2024-01-15 10:30:00"
}

การตอบกลับเมื่อเกิดข้อผิดพลาด

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Invalid API key"
    }
}

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

ตัวอย่างด่วน

คำขอ

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: YOUR_API_KEY"

การตอบกลับ

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

แนวทางปฏิบัติที่ดี

• เก็บ API key ของคุณอย่างปลอดภัย (ไม่ควรใส่ในโค้ดฝั่งไคลเอนต์)
• ใช้ระบบ retry logic สำหรับการตอบกลับ 429 (เกินขีดจำกัด)
• แคชการตอบกลับเมื่อเป็นไปได้เพื่อลดการเรียก API
• ใช้ HTTPS สำหรับคำขอทั้งหมด

เคล็ดลับ: ทดสอบการเชื่อมต่อของคุณในชุดเล็กๆ ก่อนเพื่อให้แน่ใจว่าอยู่ในขีดจำกัดการใช้งาน

เอกสารฉบับสมบูรณ์

เอกสาร API ฉบับสมบูรณ์พร้อมพารามิเตอร์และตัวอย่างโดยละเอียดมีอยู่ที่:

เริ่มต้นใช้งาน

1. ตรวจสอบให้แน่ใจว่าคุณมีการสมัครสมาชิก Pro
2. ติดต่อฝ่ายสนับสนุนเพื่อขอการเข้าถึง API และรับ key ของคุณ
3. ทบทวนเอกสารสำหรับ endpoint ที่พร้อมใช้งาน

ปัจจุบันอยู่ในเวอร์ชัน Beta: เรากำลังขยาย endpoint และฟังก์ชันการทำงานของ API อย่างต่อเนื่อง หากคุณสนใจที่จะใช้ API หรือต้องการ endpoint เฉพาะ กรุณาติดต่อทีมสนับสนุนของเรา