ขอใช้งานและสร้างคีย์

การเปิดใช้งานทำเป็นรายองค์กร หลังจากนั้นเจ้าของหรือผู้ดูแลระบบขององค์กรนั้นจะจัดการคีย์ได้เอง ขั้นตอนทั้งหมดนี้ไม่ต้องสมัครบัญชีนักพัฒนาแยก เพราะคีย์อยู่ใน ABSERP

1. สมัครใช้บริการ

กรอกแบบฟอร์มสมัครใช้บริการ เราอ่านทุกคำขอด้วยเจ้าหน้าที่ และจะตอบกลับทางอีเมลภายใน 1–2 วันทำการ การระบุประเภทเอกสารและปริมาณต่อเดือนที่คาดไว้จะช่วยให้เราตอบได้เร็วขึ้น

ตัวฟอร์มเองถูกจำกัดอัตราการส่งไว้ที่ 5 ครั้งต่อ 10 นาทีต่อ IP address เพื่อกันไม่ให้ถูกส่งข้อมูลขยะเข้ามา หากส่งถี่เกินไปจะได้รับ 429 Too Many Requests พร้อม "errorCode": "OpenAPIRequestRateLimitExceeded" ให้รอสักครู่แล้วลองใหม่อีกครั้ง

2. สร้าง API Key

เมื่อองค์กรของคุณได้รับการเปิดใช้งาน ให้ เจ้าของหรือผู้ดูแลระบบ เข้าสู่ระบบ ABSERP แล้วไปที่

ตั้งค่าองค์กร → API Keys → สร้าง API Key

สิ่งที่ต้องกรอก

• ชื่อคีย์ — ชื่อที่คุณจะจำได้ในภายหลัง เช่น ระบบ POS หน้าร้าน หรือ Shopify connector
• วันหมดอายุ (ไม่บังคับ) — เว้นว่างไว้หากไม่ต้องการให้คีย์หมดอายุ

ระบบจะแสดงคีย์แบบเต็ม เพียงครั้งเดียว

absk_7Qm2XbV9tR4sK1pLzN6yA3wD8fH0jC5eU2gT7oIb

ให้คัดลอกไปเก็บในที่เก็บความลับของระบบคุณทันที ABSERP เก็บเฉพาะค่าแฮชของคีย์และอักษร 13 ตัวแรก (absk_7Qm2XbV9) ไว้แสดงเท่านั้น จึงไม่สามารถแสดงคีย์เต็มให้คุณอีก หากคีย์หายให้เพิกถอนแล้วสร้างใหม่

3. เข้าใจว่าคีย์ทำงานในนามใคร

คีย์หนึ่งใบพาข้อมูลสำคัญสองอย่างไปกับทุก request

• องค์กร ทุก request จะถูกจำกัดขอบเขตอยู่ที่ข้อมูลขององค์กรนั้น เสมือนสมาชิกขององค์กรเรียกเอง และไม่มีทางเข้าถึงองค์กรอื่นด้วยคีย์เดียวกัน
• ผู้ใช้ที่สร้างคีย์ เอกสารที่สร้างผ่านคีย์จะบันทึกผู้สร้างเป็นผู้ใช้คนนั้น (แสดงในเว็บแอปและในประวัติการตรวจสอบ) หากไม่ต้องการให้ทราฟฟิกจากระบบไปผูกกับชื่อพนักงานจริง ให้สร้างคีย์ด้วยบัญชีที่ตั้งไว้สำหรับงานระบบ

4. ดูแลคีย์ให้ปลอดภัย

• ปฏิบัติกับคีย์เหมือนรหัสผ่าน — ใช้ฝั่งเซิร์ฟเวอร์เท่านั้น ห้ามฝังในโค้ดฝั่งเบราว์เซอร์ แอปมือถือ หรือ repository สาธารณะ
• แยกคีย์หนึ่งใบต่อการเชื่อมต่อหนึ่งระบบ เพื่อให้เพิกถอนระบบเดียวได้โดยไม่กระทบระบบอื่น
• กำหนดวันหมดอายุให้งานระยะสั้น เช่น การทดลองระบบ หรือคีย์ที่ให้ผู้รับจ้างภายนอกใช้
• เวลาหมุนเวียนคีย์ ให้สร้างคีย์ใหม่ นำขึ้นระบบ แล้วจึงเพิกถอนคีย์เก่า ระหว่างช่วงคาบเกี่ยวคีย์ทั้งสองใช้งานได้พร้อมกัน

5. เพิกถอนคีย์

ที่ ตั้งค่าองค์กร → API Keys กดปุ่ม เพิกถอน ที่แถวของคีย์ การเพิกถอนมีผลทันทีและย้อนกลับไม่ได้ แถวข้อมูลจะยังอยู่ในรายการโดยขึ้นสถานะ เพิกถอนแล้ว เพื่อคงประวัติการตรวจสอบไว้ ทุก request ที่ใช้คีย์ที่เพิกถอนแล้วจะได้รับ 401

ในรายการมีคอลัมน์ ใช้งานล่าสุด ซึ่งเป็นวิธีที่เร็วที่สุดในการหาคีย์ที่ไม่มีระบบใดเรียกใช้แล้ว

ข้อจำกัด

• หนึ่งองค์กรมีคีย์ที่ใช้งานอยู่ได้ไม่เกิน 20 คีย์ หากครบแล้วให้เพิกถอนคีย์ที่ไม่ใช้ก่อนสร้างใหม่
• คีย์ที่หมดอายุมีพฤติกรรมเหมือนคีย์ที่เพิกถอนแล้ว คือได้รับ 401

ขั้นตอนถัดไป

อ่านต่อที่ การยืนยันตัวตน