# โทเค็น API | Procurize.AI

**สร้าง จัดการ และใช้โทเค็น API เพื่อการเข้าถึงแบบโปรแกรมที่ปลอดภัยในพื้นที่ทำงาน Procurize.AI ของคุณ**

> **ใช้กับ:** แผงควบคุม Procurize.AI → การตั้งค่า → โทเค็น  
> **พร้อมใช้ใน:** แผน Business & Enterprise  
> **บทบาทที่ต้องการ:** ผู้ดูแลระบบ (Admin) หรือผู้ดูแล (Maintainer)

## ภาพรวม

โทเค็น API ช่วยให้เข้าถึงแพลตฟอร์ม Procurize.AI อย่างปลอดภัยโดยอัตโนมัติ คุณสามารถใช้โทเค็นเพื่อเชื่อมต่อ Procurize.AI กับระบบภายในของคุณ อัตโนมัติกระบวนการทำงาน หรือสร้างแอปพลิเคชันแบบกำหนดเองบนแพลตฟอร์ม

**คุณลักษณะสำคัญ:**

- โทเค็นสืบทอด **สิทธิทั้งหมด** ของผู้ใช้ที่สร้างมัน  
- โทเค็นมีขอบเขต **ระดับองค์กร** – ไม่จำเป็นต้องระบุ `org` ในการเรียก API  
- สามารถสร้างโทเค็นได้ไม่จำกัดจำนวน  
- โทเค็นสามารถมี **วันหมดอายุ** หรือกำหนดให้ไม่มีวันหมดอายุ  
- โทเค็นสามารถ **ถูกปิดใช้งาน** และต่อมา **เปิดใช้งานใหม่** ตามต้องการ  

> 🔒 **หมายเหตุด้านความปลอดภัย:** Procurize.AI **ไม่** จัดเก็บค่าจริงของโทเค็น – มีเพียงแฮชเท่านั้น คุณต้องคัดลอกและบันทึกโทเค็นทันทีหลังจากสร้าง เพราะจะไม่แสดงอีกครั้ง

## การเข้าถึงแผงการจัดการโทเค็น

1. ไปที่ **Dashboard** → **Settings** → แท็บ **Tokens**  
2. แผงการจัดการโทเค็นจะแสดงโทเค็นส่วนบุคคลของคุณที่เชื่อมกับองค์กรปัจจุบัน

![แผงโทเค็น API](/images/docs/api-tokens-panel.png)

> **สิทธิที่ต้องการ:** ผู้ใช้ที่มีบทบาท **Admin** หรือ **Maintainer** เท่านั้นจึงเข้าถึงแผงนี้ได้ ดูคำนิยามบทบาทอย่างละเอียดได้ที่ [ภาพรวมสิทธิ์](/what-user-permissions-does-procurize-have/) 

## การสร้างโทเค็นใหม่

1. ป้อน **ชื่อ** เพื่อระบุวัตถุประสงค์ของโทเค็น  
2. เลือก **ช่วงเวลาหมดอายุ**:
   - 1 เดือน  
   - 3 เดือน  
   - 1 ปี  
   - **ไม่มีวันหมดอายุ** (ใช้งานได้ไม่จำกัด)  
3. คลิก **"Generate"**

### สำคัญ – คัดลอกโทเค็นทันที

หลังจากสร้างแล้วค่าจริงของโทเค็นจะ **แสดงเพียงครั้งเดียว** – คัดลอกและจัดเก็บอย่างปลอดภัย (เช่นในผู้จัดการรหัสผ่านหรือเป็นตัวแปรสภาพแวดล้อม)

![โทเค็น API ใหม่](/images/docs/new-api-token.png)

> ⚠️ **คุณจะไม่สามารถดูค่าของโทเค็นอีกครั้ง** Procurize.AI จะเก็บเพียงแฮชที่ใช้สำหรับการยืนยัน หากคุณทำโทเค็นหาย ต้องเพิกถอนและสร้างใหม่ทันที

## การจัดการโทเค็นที่มีอยู่

แผงโทเค็นจะแสดงรายการโทเค็นทั้งหมดที่สร้างไว้พร้อมด้วย:

- ชื่อ  
- ส่วนต่อท้าย  
- วันที่สร้าง  
- วันหมดอายุ (หรือ “-”)  
- สถานะ: **ใช้งาน** หรือ **ไม่ใช้งาน**

### การปิดใช้งาน / เปิดใช้งานโทเค็น

- **Deactivate** – ปิดการใช้งานโทเค็นชั่วคราว คุณสามารถเปิดใช้งานใหม่เมื่อจำเป็น  
- **Reactivate** – คืนสถานะเป็นใช้งานให้โทเค็นที่เคยถูกปิดใช้งานแล้ว  

> 💡 การปิดใช้งานเป็นประโยชน์เมื่อคุณต้องระงับการเชื่อมต่อชั่วคราวโดยไม่ต้องลบโทเค็น

### การเพิกถอนโทเค็น

- **Revoke** – ลบโทเค็นอย่างถาวร การกระทำนี้ไม่สามารถย้อนกลับได้  
- หากคุณทำโทเค็นหาย ให้เพิกถอนทันทีและสร้างโทเค็นใหม่

## การใช้โทเค็น API

### URL พื้นฐานและการรับรองตัวตน

| พารามิเตอร์ | ค่า |
|------------|------|
| **Base URL** | `https://api.procurize.com` |
| **Authentication method** | API key via header |
| **Header** | `X-API-Key: <YOUR_API_TOKEN>` |

### ตัวอย่างคำสั่ง (cURL)

```bash
curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"
```

> 🧠 **ไม่ต้องระบุ ID ขององค์กร** – โทเค็นผูกกับองค์กรของคุณแล้ว API จะสรุปบริบทโดยอัตโนมัติ

## กฎความปลอดภัยและการใช้งานสำคัญ

| กฎ | คำอธิบาย |
|-----|-----------|
| **สิทธิของโทเค็น** | โทเค็นมีสิทธิเท่ากับผู้ใช้ที่สร้าง หากบทบาทของผู้ใช้เปลี่ยน สิทธิของโทเค็นก็จะอัปเดตตาม |
| **การผูกกับองค์กร** | โทเค็นผูกกับองค์กรของผู้สร้าง ไม่สามารถใช้โทเค็นเดียวกันข้ามหลายองค์กรได้ |
| **การมองเห็นโทเค็น** | ค่าโทเค็นจะแสดง **เพียงครั้งเดียว** ต้องบันทึกไว้ทันที Procurize.AI จะเก็บเฉพาะแฮช |
| **โทเค็นที่หมดอายุ** | โทเค็นที่หมดอายุจะถูกปิดใช้งานโดยอัตโนมัติและไม่สามารถใช้ได้ ให้สร้างโทเค็นใหม่หากต้องการต่อ |

## การแก้ไขปัญหา

| ปัญหา | วิธีแก้ |
|--------|----------|
| **ข้อผิดพลาด “Invalid API key”** | ตรวจสอบว่าคัดลอกโทเค็นอย่างถูกต้อง (ไม่มีช่องว่างเพิ่มเติม) ยืนยันว่าโทเค็นยังอยู่ในสถานะใช้งานและไม่ได้หมดอายุ |
| **โทเค็นไม่ทำงานหลังจากเปลี่ยนบทบาท** | สิทธิของโทเค็นจะอัปเดตให้ตรงกับบทบาทปัจจุบันของผู้ใช้ หากผู้ใช้สูญเสียสิทธิ โทเค็นก็จะสูญเสียสิทธิด้วย |
| **โทเค็นหาย** | เพิกถอนโทเค็นที่หายและสร้างโทเค็นใหม่ |
| **การจำกัดอัตรา** | การจำกัดอัตราการเรียก API จะขึ้นกับแผนของคุณ ตรวจสอบหัวข้อ `X-RateLimit-*` ในการตอบกลับ |

## หัวข้อที่เกี่ยวข้อง

- [ภาพรวมสิทธิ์](/what-user-permissions-does-procurize-have/) – คำนิยามบทบาทโดยละเอียด  
- [แผนราคา](https://www.procurize.ai/pricing/) – แผนใดบ้างที่รวมการเข้าถึง API  
- [เอกสารอ้างอิง REST API](/rest-api-reference/) – รายละเอียดจุดเชื่อมต่อ API  

{{<article-feedback>}}