> 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/quickstart.md).

# เริ่มต้นอย่างรวดเร็ว

> ออก API โทเค็นและส่งคำขอแรกไปยัง BoxHero API

คู่มือนี้จะพาคุณตั้งแต่ยังไม่มีโทเค็นไปจนถึงการเรียก API ครั้งแรกที่สำเร็จ

## 1. ออก API โทเค็น

ในเว็บแอปบนเดสก์ท็อป ให้เปิดทีมที่ต้องการเชื่อมต่อแล้วไปที่ `การตั้งค่า` > `การเชื่อมต่อ` สร้าง API โทเค็นใหม่แล้วคัดลอกไว้

![](https://assets.boxhero.io/docs/images/e6bbc8fa4eab21ec0f9ebe74893cd3a6e0c6a5d4d178ae02478ef99adbe4c4cd-2214x1431.jpg)

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

## 2. ส่งคำขอแรก

เรียก [ดูทีมที่เชื่อมต่อ](https://www.boxhero.io/docs/th/developers/api/reference/teams/get-linked-team) เพื่อตรวจสอบว่าโทเค็นใช้งานได้ โดยส่งโทเค็นในเฮดเดอร์ `Authorization`:

```bash
curl https://rest.boxhero-app.com/v1/teams/linked \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

การตอบกลับจะอธิบายทีมที่โทเค็นนั้นเป็นของ:

```json
{
  "id": 149058,
  "name": "Acme Retail",
  "mode": 2,
  "currency_symbol": "$",
  "currency_code": "USD",
  "price_decimal_places": 2,
  "memo": null
}
```

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

> **Note**
>
> endpoint ส่วนใหญ่ใช้ได้เฉพาะทีมที่จัดการสต็อกตาม[ตำแหน่งจัดเก็บ](https://www.boxhero.io/docs/th/concepts/locations) สำหรับทีมอื่นจะส่งคืนข้อผิดพลาดประเภท `/errors/invalid-team-mode` ทีมที่ใช้ตำแหน่งจัดเก็บจะมี `mode` เป็น `2` ในการตอบกลับข้างต้น

## 3. ขั้นตอนถัดไป

- ดูรายการสต็อกด้วย [แสดงรายการสินค้า](https://www.boxhero.io/docs/th/developers/api/reference/items/list-items) และเรียนรู้วิธีดึงข้อมูลทุกหน้าใน [การแบ่งหน้า](https://www.boxhero.io/docs/th/developers/api/pagination)
- บันทึกการเปลี่ยนแปลงสต็อกด้วย [สร้างธุรกรรม](https://www.boxhero.io/docs/th/developers/api/reference/transactions/create-transaction) โดยดูกฎได้ที่ [ธุรกรรม](https://www.boxhero.io/docs/th/developers/api/reference/transactions)
- รับการแจ้งเตือนเมื่อมีการเปลี่ยนแปลงด้วย [Webhook](https://www.boxhero.io/docs/th/developers/webhooks/overview) แทนการ polling
- ดูทุก endpoint ได้ใน [เอกสารอ้างอิง API](https://www.boxhero.io/docs/th/developers/api/reference)