Brick API Documentation
Brick

Otentikasi dan Lingkungan

Otentikasi

Brick APIs menggunakan token akses publik satu kali yang berumur pendek untuk autentikasi API. Setiap token valid untuk satu permintaan dan kedaluwarsa dalam waktu 5 menit setelah pembuatan.

Alur autentikasi ini berlaku untuk Brick APIs umum yang menggunakan header publicAccessToken. QR Code SNAP and Disbursement SNAP APIs menggunakan aliran token akses B2B SNAP terpisah di bawah QR Code SNAP.

Poin Penting

  • Token yang dihasilkan untuk satu permintaan API tidak dapat digunakan kembali untuk permintaan lainnya.
  • Setiap panggilan API memerlukan token yang baru dibuat, meskipun Anda melakukan operasi yang sama berulang kali.
  • Token berlaku selama 5 menit setelah pembuatan. Setelah masa berlaku token habis, buatlah token baru sebelum mencoba kembali permintaan tersebut.

👍 Praktik Terbaik

Hasilkan token akses publik baru segera sebelum setiap permintaan API. Hal ini menjaga integrasi tetap tangguh ketika permintaan dicoba ulang, ditunda, atau dimasukkan dalam antrean.


Lingkungan yang Tersedia

Brick menyediakan dua lingkungan terpisah untuk kasus penggunaan pengembangan dan produksi.

Untuk menghasilkan dan mengelola kredensial API Anda untuk setiap lingkungan, masuk ke Brick Dashboard, buka menu Configuration, dan pilih tab API Credentials.

Lingkungan HidupURL dasarTujuan
kotak pasirhttps://sandbox.onebrick.io/v2Gunakan lingkungan ini untuk pengujian dan pengembangan. Ini mensimulasikan perilaku langsung menggunakan data tiruan.
Produksihttps://api.onebrick.io/v2Gunakan lingkungan ini untuk aplikasi langsung yang terhubung ke lembaga keuangan nyata.

🚧 Catatan Penting

  • Kredensial berbeda untuk setiap lingkungan. Pastikan Anda menggunakan client_key dan client_secret yang benar untuk lingkungan tempat Anda bekerja.
  • Transaksi di lingkungan Sandbox tidak memengaruhi akun atau institusi nyata.
  • Sebelum beralih ke Produksi, pastikan integrasi Anda telah diuji di 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.

Cara membuat ulang Client Secret

Buat Client Secret baru melalui tab API Credentials saat Anda perlu merotasi secret integrasi.

  1. Di Brick Dashboard, buka Configuration → API Credentials.
  2. Pilih Testing atau Live sesuai lingkungan yang ingin diperbarui.
  3. Klik Generate new secret.
  4. Perbarui konfigurasi backend dengan Client Secret yang baru.

Tampilan API Credentials di Brick Dashboard dengan tombol Generate new secret

🚧 Penting

Jaga kerahasiaan Client Secret. Simpan hanya di lingkungan backend yang aman. Jangan tampilkan dalam kode frontend, repositori sumber, atau kanal publik.

Last modified on