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

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

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

ภาพรวม#

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

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

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

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

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

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

แผงโทเค็น API

สิทธิที่ต้องการ: ผู้ใช้ที่มีบทบาท Admin หรือ Maintainer เท่านั้นจึงเข้าถึงแผงนี้ได้ ดูคำนิยามบทบาทอย่างละเอียดได้ที่ ภาพรวมสิทธิ์

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

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

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

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

โทเค็น API ใหม่

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

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

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

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

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

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

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

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

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

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

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

พารามิเตอร์ค่า
Base URLhttps://api.procurize.com
Authentication methodAPI key via header
HeaderX-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-* ในการตอบกลับ

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

ไปด้านบน
เลือกภาษา