# Authentication (/developer/authentication)

Token 2 ประเภทของ EasyDonate API - API key ส่วนตัวและ OAuth access token

ทุก request ยืนยันตัวตนด้วย header เดียวกัน:

```
Authorization: Bearer <token>
```

## ประเภทของ token [#ประเภทของ-token]

| Token | ประเภท | ทำงานในนาม | ได้มาจาก |
| --- | --- | --- | --- |
| `Bearer ezdn_v1_<cuid>` | API key ส่วนตัว | บัญชีของคุณเอง | <NavPath href="https://easydonate.app/dashboard/developer?tab=apiKeys" items={['หน้าจัดการ', 'โซนผู้พัฒนา', 'API Keys']} /> |
| `Bearer <jwt>` | OAuth access token | ผู้ใช้ที่กดยินยอม | [ขั้นตอน OAuth](/developer/oauth) |

API key เป็น opaque string ขึ้นต้นด้วย `ezdn_v1_` ส่วน OAuth access token เป็น JWT ที่มีอายุสั้น หน้าตาจะเป็น `xxxxx.yyyyy.zzzzz` ไม่ใช่ string ที่มี prefix

ลองยิงด้วย token ของคุณ:

<Playground path="/api/v1/me" method="get" />

## เลือกแบบไหนดี [#เลือกแบบไหนดี]

- ทำสคริปต์หรือเครื่องมือใช้กับบัญชีตัวเอง -> API key ส่วนตัว
- ทำแอปหรือแพลตฟอร์มให้ผู้ใช้ EasyDonate คนอื่น -> [OAuth](/developer/oauth)

## Scope และ 403 [#scope-และ-403]

Token ทุกตัวถูกจำกัดด้วย scope - หาก token ไม่มี scope ที่ endpoint นั้นต้องการ request จะถูกปฏิเสธด้วย `403` ดูรายการ scope ทั้งหมดได้ที่หน้า [Scopes](/developer/scopes)

<Callout type="warn">
  เก็บ token ไว้ฝั่ง server เท่านั้น - อย่าฝัง API key หรือ `client_secret`
  ในโค้ดฝั่ง browser หรือแอปที่แจกให้ผู้ใช้
</Callout>