โทเค็น API | Procurize.AI#
สร้าง จัดการ และใช้โทเค็น API เพื่อการเข้าถึงแบบโปรแกรมที่ปลอดภัยในพื้นที่ทำงาน Procurize.AI ของคุณ
ใช้กับ: แผงควบคุม Procurize.AI → การตั้งค่า → โทเค็น
พร้อมใช้ใน: แผน Business & Enterprise
บทบาทที่ต้องการ: ผู้ดูแลระบบ (Admin) หรือผู้ดูแล (Maintainer)
ภาพรวม#
โทเค็น API ช่วยให้เข้าถึงแพลตฟอร์ม Procurize.AI อย่างปลอดภัยโดยอัตโนมัติ คุณสามารถใช้โทเค็นเพื่อเชื่อมต่อ Procurize.AI กับระบบภายในของคุณ อัตโนมัติกระบวนการทำงาน หรือสร้างแอปพลิเคชันแบบกำหนดเองบนแพลตฟอร์ม
คุณลักษณะสำคัญ:
- โทเค็นสืบทอด สิทธิทั้งหมด ของผู้ใช้ที่สร้างมัน
- โทเค็นมีขอบเขต ระดับองค์กร – ไม่จำเป็นต้องระบุ
orgในการเรียก API - สามารถสร้างโทเค็นได้ไม่จำกัดจำนวน
- โทเค็นสามารถมี วันหมดอายุ หรือกำหนดให้ไม่มีวันหมดอายุ
- โทเค็นสามารถ ถูกปิดใช้งาน และต่อมา เปิดใช้งานใหม่ ตามต้องการ
🔒 หมายเหตุด้านความปลอดภัย: Procurize.AI ไม่ จัดเก็บค่าจริงของโทเค็น – มีเพียงแฮชเท่านั้น คุณต้องคัดลอกและบันทึกโทเค็นทันทีหลังจากสร้าง เพราะจะไม่แสดงอีกครั้ง
การเข้าถึงแผงการจัดการโทเค็น#
- ไปที่ Dashboard → Settings → แท็บ Tokens
- แผงการจัดการโทเค็นจะแสดงโทเค็นส่วนบุคคลของคุณที่เชื่อมกับองค์กรปัจจุบัน

สิทธิที่ต้องการ: ผู้ใช้ที่มีบทบาท Admin หรือ Maintainer เท่านั้นจึงเข้าถึงแผงนี้ได้ ดูคำนิยามบทบาทอย่างละเอียดได้ที่ ภาพรวมสิทธิ์
การสร้างโทเค็นใหม่#
- ป้อน ชื่อ เพื่อระบุวัตถุประสงค์ของโทเค็น
- เลือก ช่วงเวลาหมดอายุ:
- 1 เดือน
- 3 เดือน
- 1 ปี
- ไม่มีวันหมดอายุ (ใช้งานได้ไม่จำกัด)
- คลิก “Generate”
สำคัญ – คัดลอกโทเค็นทันที#
หลังจากสร้างแล้วค่าจริงของโทเค็นจะ แสดงเพียงครั้งเดียว – คัดลอกและจัดเก็บอย่างปลอดภัย (เช่นในผู้จัดการรหัสผ่านหรือเป็นตัวแปรสภาพแวดล้อม)

⚠️ คุณจะไม่สามารถดูค่าของโทเค็นอีกครั้ง 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)#
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-* ในการตอบกลับ |
หัวข้อที่เกี่ยวข้อง#
- ภาพรวมสิทธิ์ – คำนิยามบทบาทโดยละเอียด
- แผนราคา – แผนใดบ้างที่รวมการเข้าถึง API
- เอกสารอ้างอิง REST API – รายละเอียดจุดเชื่อมต่อ API
