การเริ่มต้นใช้งานบัญชีย่อย B2C API
📘 API นี้มีให้สำหรับลูกค้า B2C เท่านั้น
พันธมิตรที่มีผู้ใช้ปลายทางเป็นบุคคลธรรมดาหรือธุรกิจที่ไม่ได้จดทะเบียน (เช่น ไม่มีองค์กรธุรกิจที่ถูกกฎหมาย) บัญชี Brick สามารถกำหนดค่าสำหรับโหมด B2B หรือ B2C เท่านั้น ไม่ใช่ทั้งสองโหมด
การเริ่มต้นใช้งานบัญชีย่อย B2C API ช่วยให้พันธมิตร Brick สามารถสร้างและจัดการบัญชีย่อยสำหรับผู้ใช้ปลายทางโดยใช้โปรแกรมได้ เหมาะสำหรับแพลตฟอร์มที่ให้บริการครีเอเตอร์ ฟรีแลนซ์ หรือเจ้าของธุรกิจขนาดเล็ก
API นี้มาแทนที่ขั้นตอนการเริ่มต้นใช้งานด้วยตนเอง และรองรับวงจรการจัดเตรียมบัญชีแบบเต็ม รวมถึงการสร้างคีย์ API อัตโนมัติ การจัดการข้อมูลประจำตัวที่ปลอดภัย และการตั้งค่าบัญชีย่อยที่มีประสิทธิภาพ
คุณสมบัติที่สำคัญ
- สร้างบัญชีย่อยโดยทางโปรแกรมผ่าน API
- สร้าง
client_keyและclient_secretที่ปลอดภัยโดยอัตโนมัติ - สร้างข้อมูลประจำตัวใหม่หากถูกบุกรุกหรือหมดอายุ
- อัปโหลดคีย์สาธารณะสำหรับตรวจสอบคำขอที่ลูกค้าลงนาม
จุดสิ้นสุด API
ก่อนที่จะเจาะลึกไปยังตำแหน่งข้อมูล ตรวจสอบให้แน่ใจว่าคุณได้ตรวจสอบและทำความเข้าใจวิธีสร้าง X-Signature ที่ใช้ในส่วนหัวของคำขอ คุณสามารถอ่านคู่มือ here ได้
-
ตั้งค่าคีย์สาธารณะของคุณ
อัปโหลด public key ที่ใช้ในการตรวจสอบการสื่อสารที่เข้ารหัสหรือลงนามจากไคลเอนต์ไปยัง Brick
ขั้นตอนนี้จำเป็นก่อนที่จะสร้างบัญชีย่อย
📘 รหัสสาธารณะที่อัปโหลดต้องอยู่ในรูปแบบ PEM และต้องตรงกับรหัสส่วนตัวที่ระบบของคุณเก็บไว้สำหรับการลงนามเพย์โหลด โปรดดูการตั้งค่าคีย์สาธารณะ API -
สร้างบัญชีย่อย
สร้างบัญชีย่อยใหม่ด้วยชื่อที่กำหนดเอง รหัสบัญชีย่อย และโลโก้เสริม ดูรายละเอียดได้ที่ B2C Client - Create Subaccount API reference -
สร้างคีย์ API ใหม่
ใช้ตำแหน่งข้อมูลนี้เพื่อหมุนเวียนคีย์ API สำหรับบัญชีย่อย ดูรายละเอียดได้ที่ B2C Client - Regenerate API Key API reference
⚠️ การจัดการข้อผิดพลาด
API ส่งคืนข้อความแสดงข้อผิดพลาดที่เป็นมาตรฐานเพื่อการแก้ไขปัญหาที่ง่ายขึ้น:
การตอบสนองข้อผิดพลาด
API ส่งคืนข้อความแสดงข้อผิดพลาดที่เป็นมาตรฐานเพื่อการแก้ไขปัญหาที่ง่ายขึ้น
| รหัส HTTP | ข้อความ | คำอธิบาย |
|---|---|---|
| 400 | คำขอไม่ถูกต้อง | ขาดช่องที่ต้องกรอก ข้อมูลมีรูปแบบไม่ถูกต้อง |
| 400 | รูปภาพใหญ่เกินไป | รูปภาพที่อัปโหลดเกินขีดจำกัดขนาดที่อนุญาต |
| 401 | ไม่ได้รับอนุญาต | โทเค็นไม่ถูกต้องหรือโทเค็นผู้ถือหายไป |
| 404 | ไม่พบบัญชีย่อย | ไม่มีบัญชีย่อยที่ร้องขอ |
| 403 | ต้องห้าม | ไม่อนุญาตให้ดำเนินการสำหรับประเภทหรือสถานะบัญชีปัจจุบัน |
| 403 | ไม่พบคีย์สาธารณะ | ไคลเอนต์ยังไม่ได้อัปโหลดรหัสสาธารณะ |
| 409 | ความขัดแย้ง | รหัสบัญชีย่อยซ้ำ |
| 429 | เกินขีดจำกัดอัตรา | คำขอมากเกินไป |
| 500 | ข้อผิดพลาดเซิร์ฟเวอร์ภายใน | ระบบขัดข้อง—ลองอีกครั้งในภายหลัง |
