Brick API Documentation
Brick

การรับรองความถูกต้องและสภาพแวดล้อม

การรับรองความถูกต้อง

Brick APIs ใช้โทเค็นการเข้าถึงสาธารณะแบบครั้งเดียวที่มีอายุสั้นสำหรับการตรวจสอบความถูกต้อง API แต่ละโทเค็นใช้ได้สำหรับคำขอเดียวและหมดอายุภายใน 5 นาทีนับจากการสร้าง

ขั้นตอนการตรวจสอบสิทธิ์นี้ใช้กับ Brick APIs ทั่วไปที่ใช้ส่วนหัว publicAccessToken QR Code SNAP and Disbursement SNAP APIs ใช้โฟลว์โทเค็นการเข้าถึง SNAP B2B แยกต่างหากภายใต้ QR Code SNAP

ประเด็นสำคัญ

  • โทเค็นที่สร้างขึ้นสำหรับคำขอ API หนึ่งรายการไม่สามารถใช้ซ้ำกับคำขออื่นได้
  • การเรียก API แต่ละครั้งต้องใช้โทเค็นที่สร้างขึ้นใหม่ แม้ว่าคุณจะดำเนินการเดิมซ้ำๆ ก็ตาม
  • โทเค็นมีอายุ 5 นาทีหลังจากรุ่น หลังจากโทเค็นหมดอายุ ให้สร้างโทเค็นใหม่ก่อนลองส่งคำขออีกครั้ง

👍 แนวปฏิบัติที่ดีที่สุด

สร้างโทเค็นการเข้าถึงสาธารณะใหม่ทันทีก่อนคำขอ API แต่ละรายการ สิ่งนี้ช่วยให้การผสานรวมมีความยืดหยุ่นเมื่อมีการลองคำขอใหม่ ล่าช้า หรือเข้าคิว


สภาพแวดล้อมที่มีอยู่

Brick มีสภาพแวดล้อมสองแบบแยกกันสำหรับกรณีการใช้งานการพัฒนาและการใช้งานจริง

หากต้องการสร้างและจัดการข้อมูลรับรอง API ของคุณสำหรับแต่ละสภาพแวดล้อม ให้เข้าสู่ระบบ Brick Dashboard เปิดเมนู Configuration และเลือกแท็บ API Credentials

สิ่งแวดล้อมURL ฐานวัตถุประสงค์
แซนด์บ็อกซ์https://sandbox.onebrick.io/v2ใช้สภาพแวดล้อมนี้สำหรับการทดสอบและพัฒนา มันจำลองพฤติกรรมสดโดยใช้ข้อมูลจำลอง
การผลิตhttps://api.onebrick.io/v2ใช้สภาพแวดล้อมนี้สำหรับแอปพลิเคชันถ่ายทอดสดที่เชื่อมต่อกับสถาบันการเงินจริง

🚧 หมายเหตุสำคัญ

  • ข้อมูลประจำตัวจะแตกต่างกันไปในแต่ละสภาพแวดล้อม ตรวจสอบให้แน่ใจว่าคุณใช้ client_key และ client_secret ที่ถูกต้องสำหรับสภาพแวดล้อมที่คุณทำงานอยู่
  • ธุรกรรมในสภาพแวดล้อม Sandbox จะไม่ส่งผลกระทบต่อบัญชีหรือสถาบันจริง
  • ก่อนที่จะเปลี่ยนไปใช้เวอร์ชันที่ใช้งานจริง ตรวจสอบให้แน่ใจว่าการผสานรวมของคุณได้รับการทดสอบใน Sandbox แล้ว

SNAP API environments

For SNAP APIs, use the environment root URL without a version suffix. Each endpoint already includes its required /v2 or /v3 prefix.

EnvironmentSNAP root URL
Sandboxhttps://sandbox.onebrick.io
Productionhttps://api.onebrick.io

For reusable SNAP access tokens and request signing, see Setup Client Key and Signature.

วิธีสร้าง Client Secret ใหม่

คุณสามารถสร้าง Client Secret ใหม่จากแท็บ API Credentials เมื่อต้องการหมุนเวียน secret ที่ใช้ในการเชื่อมต่อระบบ

  1. ใน Brick Dashboard ไปที่ Configuration → API Credentials
  2. เลือก Testing หรือ Live ตามสภาพแวดล้อมที่ต้องการ
  3. คลิก Generate new secret
  4. อัปเดตการตั้งค่า backend ด้วย Client Secret ใหม่

หน้าจอ API Credentials ใน Brick Dashboard พร้อมปุ่ม Generate new secret

🚧 ข้อสำคัญ

เก็บ Client Secret เป็นความลับและจัดเก็บเฉพาะใน backend ที่ปลอดภัย ห้ามเปิดเผยในโค้ด frontend ระบบจัดการซอร์สโค้ด หรือช่องทางสาธารณะ

Last modified on