Berikut adalah panduan untuk memandu Anda melalui langkah-langkah untuk berintegrasi dengan sistem OAuth sebagai pialang. Terdiri dari lima (5) fase: persyaratan pra-pengaturan, otorisasi Bybit Indonesia, pengalihan otorisasi yang berhasil, permintaan token, dan permintaan informasi pengguna. Ikuti langkah-langkah berikut untuk memastikan kelancaran integrasi.
Fase 1: Persyaratan Pra-Pengaturan
-
UID Akun Bybit Indonesia: Hubungi tim Manajemen Pialang untuk memberikan UID akun Bybit Indonesia Anda dan mendapatkan persetujuan untuk integrasi OAuth.
-
Kirim Informasi Pialang: Setelah disetujui, kunjungi Admin OAuth Bybit Indonesia untuk mengirimkan informasi pialang Anda.
Parameter Kunci untuk Konfigurasi OAuth:
-
Beranda Aplikasi: URL pengalihan di mana pengguna akan diarahkan setelah otorisasi. Pastikan informasi tersebut benar dan sesuai dengan informasi yang diberikan selama proses pengaturan awal.
-
IP OpenAPI: Ini mengacu pada IP yang mengikat OpenAPI Anda. Informasi yang salah dapat mencegah penggunaan API.
Parameter Respons:
-
client_id: ID pialang unik Anda.
-
client_secret: Kunci rahasia Anda.
Fase 2: Prosedur Otorisasi Bybit Indonesia
Untuk mengizinkan pengguna melalui Bybit Indonesia, Anda harus mengarahkan mereka ke laman OAuth Bybit Indonesia, biasanya melalui jendela pop-up, untuk verifikasi dan otorisasi login.
Detail Halaman Otorisasi:
-
URL:
-
Mainnet: OAuth Bybit Indonesia
-
Testnet: OAuth Testnet Bybit Indonesia
-
-
METHOD: GET
-
Parameter yang Diperlukan:
-
client_id: ID pialang unik Anda.
-
response_type: ‘code’ untuk otorisasi melalui kode (disarankan), atau ‘token’ untuk otorisasi melalui token.
-
scope: Rentang izin untuk otorisasi ini (misalnya, ‘openapi, openapai’).
-
state: Indikator status opsional, nilai yang sama akan dikirim kembali oleh server Bybit Indonesia.
-
redirect_uri: URL untuk pengalihan setelah otorisasi (harus sesuai dengan yang disediakan selama pembuatan).
-
Hasil Otorisasi:
-
Success: Pengguna diarahkan kembali ke platform Anda dengan kode status 302 HTTP.
-
Failure or Cancellation: Pop-up tetap ada di laman Bybit Indonesia.
Fase 3: Pengalihan Setelah Otorisasi Berhasil (Mode Kode)
Setelah otorisasi berhasil, Anda diarahkan ke platform Anda dengan kode otorisasi.
Detail Pengalihan:
-
URL: Arahkan URI yang diberikan selama pengaturan.
-
METHOD: GET
-
HTTP Status: 302 Found
-
Parameter yang Diperlukan:
-
client_ID: ID pialang unik Anda.
-
code: Kode otorisasi.
-
Jika Anda membatalkan proses verifikasi, pengalihan akan tetap terjadi. Namun, ini tidak akan terjadi jika Anda menutup jendela pop-up.
Fase 4: Meminta Token Otorisasi
Fase ini melibatkan permintaan token otorisasi menggunakan kode otorisasi.
Detail Permintaan Token:
-
URL:
-
Mainnet: Token Akses Bybit Indonesia
-
Testnet: Token Akses Testnet Bybit Indonesia
-
-
METHOD: POST (data formulir)
-
Parameter:
-
client_id: ID pialang unik Anda.
-
client_secret: Kunci rahasia Anda.
-
code: Kode otorisasi diperoleh dari Fase 3.
-
Fase 5: Meminta Informasi Pengguna
Setelah mendapatkan token akses, Anda dapat meminta informasi pengguna, termasuk detail UID dan OpenAPI Bybit Indonesia.
Meminta UID Indonesia Bybit:
-
URL: /oauth/v1/resource/restrict/uid_bearer
-
METHOD: GET
-
Request Headers (Permintaan Header): Authorization: Bearer <access_token>
-
Expected Response (Respons yang diharapkan): JSON dengan ret_code = 0 dan ret_msg = “success”, yang menandakan proses berhasil.
Meminta Kunci dan Rahasia OpenAPI:
-
URL: /oauth/v1/resource/restrict/openapi
-
METHOD: GET
-
Request Headers (Permintaan Header): Authorization: Bearer <access_token>
-
Expected Response (Respons yang diharapkan): JSON dengan api_key dan api_secret.