Cara Membuat Kunci API WEEX: Akses Hanya Baca atau Akses Trading
Cara Membuat Kunci API WEEX: Akses Hanya Baca atau Akses Trading
Masuk ke WEEX melalui web, lalu buka Akun → Manajemen API untuk membuat kunci API. Kunci baru secara default memiliki izin Hanya Baca. Jika aplikasi perlu melakukan trading, pilih izin Spot atau Futures/Contract yang sesuai.
Sebelum membuat kunci, tentukan aplikasi mana yang akan menggunakannya. Skrip pemantau saldo dan strategi trading otomatis membutuhkan akses yang berbeda. Memilih izin yang sesuai dengan tujuan tersebut akan memudahkan Anda mengelola dan memecahkan masalah integrasi.
Izin mana yang sebaiknya saya pilih?
| Yang ingin Anda lakukan | Mulai dari mana |
|---|---|
| Membaca ticker publik, buku order, atau konfigurasi bursa | Endpoint publik tidak memerlukan autentikasi akun, jadi Anda dapat memulai tanpa kunci. |
| Memeriksa saldo atau informasi order privat | Buat kunci hanya-baca dan pastikan persyaratan izin endpoint yang dituju. |
| Melakukan trading spot melalui aplikasi | Konfigurasikan izin Spot. |
| Melakukan trading kontrak melalui aplikasi | Konfigurasikan izin Futures/Contract. |
Kunci hanya-baca tidak dapat membuat atau membatalkan order. Periksa izin trading spot dan kontrak secara terpisah; mengaktifkan salah satunya tidak berarti izin lainnya tersedia. Panduan persiapan spot dan panduan persiapan futures menjelaskan akses yang relevan.
Membuat kunci API
1. Buka Manajemen API. Setelah masuk, kunjungi Manajemen API, atau pilih Create API di halaman API WEEX.
2. Masukkan detail dan pilih izin. Ikuti kolom yang tersedia saat ini. Pertahankan akses hanya-baca untuk pemeriksaan akun, atau pilih pasar yang sesuai jika trading diperlukan.
3. Atur frasa sandi dan pengikatan IP. Frasa sandi API adalah frasa akses yang Anda pilih untuk kunci ini. FAQ resmi menyarankan penggunaan huruf dan angka tanpa karakter khusus. Konfigurasikan pengikatan IP sesuai persyaratan halaman.
4. Selesaikan verifikasi keamanan dan simpan kredensial. Simpan APIKey, SecretKey, dan Passphrase dengan aman, lalu validasi integrasi menggunakan permintaan hanya-baca yang diizinkan.
Urutan kolom dapat berubah, jadi ikuti petunjuk yang ditampilkan di akun Anda. Jika menghubungkan alat pihak ketiga, pastikan izin yang dimintanya sesuai dengan fungsi yang ingin Anda gunakan sebelum memasukkan kredensial.
Bagaimana APIKey, SecretKey, dan Passphrase digunakan?
APIKey mengidentifikasi permintaan API, SecretKey digunakan untuk membuat tanda tangan permintaan, dan Passphrase adalah frasa akses yang ditetapkan saat Anda membuat kunci. Masing-masing memiliki fungsi yang berbeda. Frasa sandi API juga berbeda dari kata sandi untuk masuk ke akun Anda.
Jika suatu alat meminta “API Password”, periksa definisi kolomnya. Misalnya, kolom password di CCXT menggunakan frasa sandi API WEEX. Nilai yang salah dapat membuat autentikasi permintaan privat gagal meskipun APIKey dan SecretKey sudah benar.
Dokumentasi resmi menyatakan bahwa frasa sandi yang hilang tidak dapat dipulihkan; Anda perlu membuat kunci API baru. Saat membuat kredensial, simpan di lingkungan server terkendali atau pengelola rahasia, bukan mengandalkan pesan obrolan, tangkapan layar, atau konstanta teks biasa di dalam kode.
Ikat IP yang benar-benar digunakan aplikasi Anda
Untuk aplikasi yang diterapkan di server, ikat IP publik keluar yang digunakannya untuk mengirim permintaan. Proksi, NAT, atau layanan cloud dapat mengubah alamat eksternal, sehingga IP privat server mungkin berbeda dari alamat sumber yang dilihat WEEX.
Periksa kembali pengikatan saat memindahkan server atau mengubah jaringan keluar. Akun standar harus mengikuti petunjuk di Manajemen API. API untuk pengguna akhir broker memiliki aturan terpisah; batas jumlah IP atau persyaratan wajibnya tidak berlaku untuk semua akun.
Kedua panduan persiapan menyatakan bahwa setiap pengguna dapat membuat hingga 10 grup kunci API. Memisahkan kunci berdasarkan tujuan aplikasi—misalnya, satu untuk memantau akun dan satu untuk trading—memudahkan Anda mengganti atau menonaktifkan integrasi tertentu nanti.
Mengapa kunci masih mungkin gagal setelah dibuat?
Telusuri titik terjadinya kegagalan alih-alih berulang kali membuat kunci pengganti:
| Gejala | Periksa terlebih dahulu |
|---|---|
| Pemeriksaan akun berhasil, tetapi order gagal | Izin trading untuk pasar yang dituju. Ketidakcocokan izin adalah salah satu kemungkinan penyebab -1052. |
| Autentikasi permintaan privat gagal | Frasa sandi API, tanda tangan, stempel waktu, dan IP keluar yang sebenarnya. |
| Kunci yang baru dibuat atau diubah tidak tersedia untuk sementara | FAQ saat ini menyebutkan waktu propagasi yang umumnya sekitar 15 menit, bukan batas waktu yang dijamin. |
| Status API Restricted terus muncul | Hubungi dukungan resmi mengenai pembatasan akun, alih-alih terus mengirim permintaan yang tidak valid. |
Untuk bantuan lebih lanjut, gunakan tautan dukungan di FAQ API resmi dan sertakan waktu, endpoint, serta kode kesalahan. Sembunyikan kredensial, tanda tangan, dan data akun sensitif di dalam log.
Jika Anda menduga kunci telah terekspos, hentikan integrasi yang terdampak, hapus kunci yang terekspos, tinjau catatan akun dan order, lalu buat penggantinya dengan izin yang diperlukan.