การยืนยันตัวตน
ทุกคำขอที่ส่งถึง API มีคีย์ API แนบมาด้วย คำขอจะไม่ถูกจับคู่กับเซสชันของเบราว์เซอร์เลย
การสร้างคีย์ API
สร้างคีย์ได้ที่ คีย์ API ในบัญชีของคุณ สูงสุด 5 คีย์ คุณคัดลอกคีย์ API จากหน้านั้นได้ทุกเมื่อขณะเข้าสู่ระบบอยู่ เราเก็บคีย์ไว้แบบเข้ารหัส และแสดงให้เฉพาะคุณเห็น เก็บคีย์เป็นความลับเหมือนรหัสผ่าน และหากคีย์อาจถูกผู้อื่นเห็น ให้เพิกถอนแล้วสร้างคีย์ใหม่
การส่งคีย์ API
ส่งในเฮดเดอร์ Authorization เป็น Bearer ตามด้วยคีย์ ใช้ X-API-Key ก็ได้เช่นกัน
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"สิ่งที่คีย์ API ทำได้
คีย์ API ใหม่ทำได้ทุกอย่าง ทั้งดูยอดคงเหลือ ตัวตรวจสอบ คำสั่งซื้อ และผลลัพธ์ของคุณ และใช้ POST /uploads, POST /estimates และ POST /orders ซึ่งจัดเก็บรายชื่อของคุณหรือใช้ยอดคงเหลือของคุณ คีย์ที่สร้างก่อนวันที่ 8 พฤศจิกายน 2026 อาจเป็นแบบอ่านอย่างเดียว ซึ่งดูได้ทุกอย่าง แต่การเรียกทั้งสามนี้จะปฏิเสธคีย์ด้วย missing_scope
วันหมดอายุและที่อยู่ IP
คีย์ API ใหม่ไม่มีวันหมดอายุและใช้ได้จากทุกที่อยู่ คีย์ที่สร้างก่อนวันที่ 8 พฤศจิกายน 2026 อาจมีวันหมดอายุ ซึ่งหลังจากนั้นจะถูกปฏิเสธด้วย expired_key หรืออาจจำกัดให้ใช้ได้เฉพาะที่อยู่ IP ของเซิร์ฟเวอร์ของคุณ ทำให้คำขอจากที่อื่นถูกปฏิเสธด้วย ip_not_allowed หากต้องการเปลี่ยนอย่างใดอย่างหนึ่ง ให้สร้างคีย์ใหม่แล้วเพิกถอนคีย์เดิม
การเก็บคีย์ API ให้ปลอดภัย
- ดูแลคีย์ API เหมือนรหัสผ่าน ใครก็ตามที่มีคีย์สามารถใช้ยอดคงเหลือของคุณได้
- ใช้เฉพาะบนเซิร์ฟเวอร์ของคุณ API ไม่อนุญาตให้เรียกจากหน้าเว็บ
- อย่าเก็บไว้ในโค้ดและระบบควบคุมเวอร์ชันของคุณ
- หากคีย์ API อาจถูกผู้อื่นเห็น ให้เพิกถอนในบัญชีของคุณทันที คีย์จะหยุดทำงานในทันที คำสั่งซื้อที่ทำไปแล้วจะยังทำงานต่อไป
- ส่งไปที่ API เท่านั้น ลิงก์อัปโหลดและดาวน์โหลดมีสิทธิ์ในตัวเอง ดังนั้นอย่าส่งคีย์ API ของคุณไปยังลิงก์เหล่านั้น
เมื่อคีย์ API ถูกปฏิเสธ
คีย์ API ที่ผิด ถูกเพิกถอน หรือหมดอายุแล้วจะได้การตอบกลับ 401 คีย์ API หรือบัญชีที่ถูกบล็อกจะได้การตอบกลับ 403 ดูข้อผิดพลาด