> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/th/developers/api/authentication.md).

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

> ยืนยันตัวตนคำขอ BoxHero API ด้วย Bearer token และส่งไปยัง base URL ที่มีเวอร์ชันกำกับ

## API โทเค็น

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

```
Authorization: Bearer <api-token>
```

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

ไม่รองรับการเข้าถึงแบบไม่ระบุตัวตน เมื่อไม่มีโทเค็นหรือโทเค็นไม่ถูกต้อง ทุก endpoint จะส่งคืน `401` พร้อม[โครงสร้างข้อผิดพลาด](https://www.boxhero.io/docs/th/developers/api/errors)

> **Caution**
>
> **หมายเหตุ**: ดูแลโทเค็นเหมือนรหัสผ่าน เก็บไว้บนเซิร์ฟเวอร์ของคุณ และหากโทเค็นรั่วไหล ให้ลบโทเค็นที่ `การตั้งค่า` > `การเชื่อมต่อ` แล้วออกโทเค็นใหม่

## Base URL และการกำหนดเวอร์ชัน

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

```
https://rest.boxhero-app.com
```

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

## โหมดของทีม

endpoint ส่วนใหญ่ใช้ได้เฉพาะทีมที่จัดการสต็อกตาม[ตำแหน่งจัดเก็บ](https://www.boxhero.io/docs/th/concepts/locations) สำหรับทีมอื่นจะส่งคืน `400` พร้อมประเภทข้อผิดพลาด `/errors/invalid-team-mode` endpoint ของทีม สมาชิก คู่ค้า และคุณสมบัติใช้ได้กับทุกทีม เรียก [ดูทีมที่เชื่อมต่อ](https://www.boxhero.io/docs/th/developers/api/reference/teams/get-linked-team) เพื่อดูว่าทีมของคุณใช้โหมดใด