การตรวจสอบสิทธิ์
Reigniter API ใช้กุญแจAPIกุญแจแต่ละอันเป็นของบัญชีเดียวและทําหน้าที่เหมือนบัญชีนั้น: ใช้เครดิตของบัญชีนั้นและดูเฉพาะงานของบัญชีนั้นเท่านั้น
สร้างคีย์
หัวข้อที่มีชื่อว่า “สร้างคีย์”กุญแจAPI เป็นส่วนหนึ่งของแผนAgency
- เข้าสู่ระบบที่ Reigniter
- เปิดกุญแจบัญชี> API (
/app/account/api-keys) - ภายใต้ Create new key ให้พิมพ์ป้ายชื่อที่คุณจะรู้จักในภายหลัง เช่น
CI pipelineหรือCMS sync - เลือก สร้าง
- คัดลอกกุญแจทันที
คีย์มีลักษณะดังนี้: emp_ ตามด้วยอักขระฐานสิบหก 64 ตัว
ส่งกุญแจ
หัวข้อที่มีชื่อว่า “ส่งกุญแจ”ใส่คีย์ในส่วนหัวของ Authorization เป็นโทเค็น Bearer ทุกคําขอ:
curl https://reigniter.ai/v1/me \ -H "Authorization: Bearer $REIGNITER_API_KEY"กุญแจที่ถูกต้องจะคืน 200 กับบัญชีของคุณ:
{ "user_id": "3f1c2a9e-8b7d-4c1e-9f0a-2d6b5e4c3a21", "email": "dev@example.com", "name": "Sam", "credits_remaining": 42}เมื่อกุญแจถูกปฏิเสธ
หัวข้อที่มีชื่อว่า “เมื่อกุญแจถูกปฏิเสธ”| สถานะ | code |
ความหมาย |
|---|---|---|
401 |
NO_API_KEY |
ไม่มีส่วนหัว Authorization หรือโทเค็นไม่ขึ้นต้นด้วย emp_ |
401 |
INVALID_API_KEY |
กุญแจนั้นไม่ทราบหรือถูกเพิกถอนแล้ว |
402 |
PLAN_UPGRADE_REQUIRED |
กุญแจนี้ใช้ได้ แต่บัญชีไม่ได้อยู่ในแผนAgency |
403 |
ACCOUNT_SUSPENDED |
บัญชีที่เป็นเจ้าของกุญแจจะถูกระงับ |
ถ้าบัญชีออกจากแผน Agency กุญแจของมันจะหยุดทํางานจนกว่าจะกลับมาAgency
เก็บกุญแจเป็นความลับ
หัวข้อที่มีชื่อว่า “เก็บกุญแจเป็นความลับ”- เก็บคีย์ไว้ในตัวจัดการลับหรือตัวแปรสภาพแวดล้อมอย่าผูกมัดคีย์เหล่านั้นกับการควบคุมซอร์สโค้ด
- โทรหา API จากเซิร์ฟเวอร์ของคุณเท่านั้นอย่าส่งคีย์ในหน้าเว็บหรือแอปมือถือเด็ดขาดการร้องขอผ่านเบราว์เซอร์ไปยัง API ไม่ได้รับอนุญาตตามนโยบาย CORS ของเซิร์ฟเวอร์อยู่แล้ว
- ใช้ปุ่มหนึ่งต่อระบบ พร้อมป้ายกํากับที่ชัดเจนจากนั้นคุณสามารถเพิกถอนกุญแจหนึ่งโดยไม่ทําลายกุญแจอื่น ๆ
- หน้าจอปุ่มAPIจะแสดงว่าปุ่มแต่ละปุ่มถูกใช้เมื่อใดครั้งล่าสุดปุ่มที่คุณไม่รู้จัก หรือใช้เมื่อไม่ควรใช้ ควรถูกเพิกถอน
เพิกถอนกุญแจ
หัวข้อที่มีชื่อว่า “เพิกถอนกุญแจ”- เปิดกุญแจบัญชี> API
- ภายใต้ คีย์ที่ใช้งานอยู่ ให้ค้นหาคีย์ตามป้ายกํากับ
- เลือกไอคอน Revoke key (ถัง)
คีย์ที่ถูกเพิกถอนจะถูกปฏิเสธทันทีด้วย 401 INVALID_API_KEY.การเพิกถอนไม่สามารถย้อนกลับได้การเรนเดอร์ที่เริ่มขึ้นแล้วโดยที่คีย์ยังคงทํางานอยู่