Brick API Documentation
Brick

การเริ่มต้นใช้งานบัญชีย่อย 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ข้อผิดพลาดเซิร์ฟเวอร์ภายในระบบขัดข้อง—ลองอีกครั้งในภายหลัง
Last modified on