Cara Memulai

Semua permintaan ke API Quentrade memerlukan autentikasi kecuali jika dinyatakan lain secara eksplisit.

Dapatkan Kunci API Quentrade Anda

Kami menawarkan dua cara untuk menghasilkan Kunci API:

  • 1Dihasilkan oleh sistem (System generated)
  • 2Dihasilkan sendiri menggunakan metode enkripsi asimetris RSA

Pro Tip: Kami merekomendasikan metode kedua karena menyediakan koneksi yang lebih aman untuk aplikasi Anda.

Buat Tanda Tangan (Signature)

Titik akhir SIGNED (terenkripsi) memerlukan header Signature tambahan untuk memastikan keaslian permintaan.

Titik Akhir Signed

Untuk melakukan autentikasi, sertakan Kunci API Quentrade Anda dan header Signature di dalam permintaan.

Uji Autentikasi

Cara tercepat untuk menguji pengaturan autentikasi Anda adalah dengan mengirimkan permintaan ke titik akhir /api/v1/auth/validate. Titik akhir ini memverifikasi validitas kredensial API Anda dan mengembalikan status autentikasi Anda.

GET/api/v1/auth/validate
Permission: NoneSecurity: SIGNED

Request Headers

APIKEYstring required

Kunci API Quentrade publik Anda yang dihasilkan dari dasbor developer atau dihasilkan sendiri melalui RSA.

Signaturestring required

Hash heksadesimal HMAC SHA256 atau tanda tangan digital RSA yang dihitung untuk permintaan ini.

Contoh Permintaan (Request Example)

test_auth_endpoint.sh
curl -X GET 'https://quentrade.com/api/v1/auth/validate' \
  -H 'APIKEY: your_api_key_here' \
  -H 'Signature: your_computed_signature_here'

Respons

Jika berhasil, Quentrade mengembalikan 200 OK:

auth_success_200.json
200 OK
{
  "valid": true
}

Jika autentikasi gagal, Quentrade mengembalikan 401 Unauthorized:

auth_error_401.json
401 UNAUTHORIZED
{
  "error": "signature_invalid",
  "error_description": "Provided signature is invalid"
}