การยืนยันตัวตน

ทุกคำขอต้องมี API โทเค็นเป็น Bearer token ในเฮดเดอร์ Authorization:

Authorization: Bearer <api-token>

ออกโทเค็นได้ในแอป BoxHero ที่ การตั้งค่า > การเชื่อมต่อ โทเค็นแต่ละอันผูกกับทีมเดียว ทุกคำขอจะอ่านและเขียนข้อมูลของทีมนั้นเท่านั้น หากต้องการทำงานกับหลายทีม ให้ออกโทเค็นในแต่ละทีม

ไม่รองรับการเข้าถึงแบบไม่ระบุตัวตน เมื่อไม่มีโทเค็นหรือโทเค็นไม่ถูกต้อง ทุก endpoint จะส่งคืน 401 พร้อมโครงสร้างข้อผิดพลาด

คำขอทั้งหมดจะส่งไปที่:

https://rest.boxhero-app.com

ทุก endpoint อยู่ภายใต้ prefix /v1 เช่น GET /v1/items

endpoint ส่วนใหญ่ใช้ได้เฉพาะทีมที่จัดการสต็อกตามตำแหน่งจัดเก็บ สำหรับทีมอื่นจะส่งคืน 400 พร้อมประเภทข้อผิดพลาด /errors/invalid-team-mode endpoint ของทีม สมาชิก คู่ค้า และคุณสมบัติใช้ได้กับทุกทีม เรียก ดูทีมที่เชื่อมต่อ เพื่อดูว่าทีมของคุณใช้โหมดใด