Kode Kesalahan API WEEX Dijelaskan: Perbaiki 40001 hingga 43011 dengan Cepat

Sebagian besar kesalahan API WEEX tidak seperti yang dikatakan pesannya. 40009 API validation failed hampir tidak pernah berarti kunci Anda buruk — biasanya berarti string tanda tangan Anda disusun dalam urutan yang salah. 40102 Trading pair configuration does not exist pada pasangan yang jelas ada biasanya berarti Anda mengirim simbol futures ke domain spot. Membaca kode secara harfiah adalah hal yang mengubah perbaikan sepuluh menit menjadi pekerjaan sepanjang sore.

Ini adalah referensi kerja untuk kode kesalahan API WEEX yang benar-benar ditemui oleh integrasi langsung, dikelompokkan berdasarkan lapisan yang rusak daripada berdasarkan nomor. Setiap kode di bawah ini berasal dari daftar kode kesalahan API WEEX seperti yang diterbitkan pada 27 Juli 2026; aturan tanda tangan, waktu, dan batas kecepatan berasal dari dokumentasi API spot WEEX pada tanggal yang sama. Keduanya berubah, jadi periksa kembali sebelum Anda mengirim.

Satu klarifikasi terlebih dahulu, karena hasil pencarian mencampurnya: artikel ini tentang API bursa mata uang kripto WEEX (api-spot.weex.com dan api-contract.weex.com). Ini tidak ada hubungannya dengan Apache Weex, kerangka kerja UI seluler Alibaba yang sudah pensiun yang berbagi nama dan mengembalikan kesalahan seperti -1001. Jika pelacakan tumpukan Anda menyebutkan WXSDKInstance, Anda berada di manual yang salah.

Bagaimana kode kesalahan API WEEX dikelompokkan

Daftar resmi adalah tabel datar. Dalam praktiknya, kode-kode tersebut masuk ke dalam tujuh lapisan diagnostik, dan mengetahui lapisannya memberi tahu Anda file mana yang harus dibuka. Pengelompokan ini adalah cara tercepat untuk memangkas waktu debugging, karena lapisan 1–4 adalah klien Anda dan lapisan 7 sama sekali bukan bug Anda.

Aturan praktis: jika kode dimulai dengan 400, curigai permintaan Anda. Jika dimulai dengan 43, curigai parameter order Anda. Jika 429, 40200 atau 40015, jangan curigai apa pun dan lakukan backoff.

Kesalahan autentikasi API WEEX: 40001 hingga 40018

Pita ini menghasilkan tiket dukungan terbanyak dan masalah kredensial asli paling sedikit. Enam dari kode ini diselesaikan dengan memperbaiki cara header dibuat, bukan dengan membuat kunci baru.

Dua detail layak untuk diinternalisasi. Aturan konstruksi tanda tangan WEEX mendefinisikan string prehash sebagai timestamp + method.toUpperCase() + requestPath + "?" + queryString + body, HMAC-SHA256 dengan kunci rahasia Anda, lalu Base64. ? dan string kueri dihilangkan jika tidak ada kueri. Tiga hal yang merusak ini dalam produksi: get huruf kecil, jalur permintaan yang menyertakan host, dan isi JSON yang diserialisasi ulang oleh pustaka HTTP Anda setelah Anda menandatanganinya — urutan kunci berubah, byte berubah, dan Anda mendapatkan 40009.

Detail kedua adalah jebakan penamaan. Teks kesalahan mengutip nama header dengan garis bawah (ACCESS_KEY, ACCESS_SIGN, ACCESS_TIMESTAMP, ACCESS_PASSPHRASE), sementara dokumentasi tanda tangan menulisnya dengan tanda hubung (ACCESS-SIGN, ACCESS-TIMESTAMP). Salin formulir yang digunakan dalam dokumentasi endpoint yang Anda integrasikan dan catat header mentah pada panggilan sukses pertama Anda, daripada mempercayai string kesalahan atau cuplikan blog.

40005 vs 40008: dua bug stempel waktu yang berbeda

Keduanya terus-menerus disamakan, dan perbaikan yang salah membuang waktu paling banyak.

40005 Invalid ACCESS_TIMESTAMP adalah masalah format. Nilainya bukan zaman milidetik 13 digit — biasanya zaman detik 10 digit dari time.time() di Python atau time() di PHP, atau string ISO-8601. Ini gagal secara instan dan konsisten, pada setiap permintaan termasuk yang pertama.

40008 Request timestamp has expired adalah masalah jam atau latensi. Formatnya benar, tetapi nilainya lebih dari 30 detik dari waktu server WEEX. Permintaan hanya berlaku selama 30 detik, dan tanda tangan ditolak jika stempel waktu menyimpang lebih dari 30 detik dari jam server API ke kedua arah — mesin yang berjalan cepat gagal sama kerasnya dengan mesin yang berjalan lambat.

Drift jam di dalam container adalah penyebab paling umum dari integrasi yang "berhasil kemarin". Jika Anda tidak dapat mengontrol NTP pada host, polling endpoint waktu server saat startup, simpan delta, dan tambahkan ke jam lokal Anda untuk setiap tanda tangan.

Penolakan order: 43001 hingga 43011 dan 42002

Setelah autentikasi berlalu, kegagalan berpindah ke mesin pencocokan. Kode-kode ini murah untuk diperbaiki tetapi mahal untuk diabaikan, karena bot yang mencoba ulang order yang ditolak dalam loop ketat akan mengenai pembatas kecepatan dan menutupi masalah sebenarnya.

Satu hal yang menangkap trader berpengalaman adalah 40704 Only query data for the last three months. Backfilling riwayat trading lebih dari 90 hari tidak akan berfungsi melalui endpoint kueri standar, jadi pekerjaan rekonsiliasi apa pun perlu mempertahankan pengisian saat terjadi daripada berasumsi bahwa ia dapat mengambilnya kembali nanti.

Apa yang memicu 429 pada API WEEX

Aturan pembatasan akses menetapkan default 10 permintaan per detik kecuali endpoint individu mengatakan sebaliknya. Melebihinya mengembalikan 429 Too Many Requests, yang juga dimunculkan oleh daftar kesalahan sebagai "Requesting too frequently".

Tiga properti dari batas itu mengubah cara Anda harus mendesain di sekitarnya:

• Permintaan terautentikasi dihitung per kunci API, permintaan tidak terautentikasi per IP publik. Dua bot yang berbagi satu kunci berbagi satu anggaran. Dua bot di satu server dengan kunci terpisah tidak — tetapi polling data pasar publik mereka melakukannya, karena itu dihitung berdasarkan IP.
• Order batch di beberapa pasangan dihitung sebagai satu permintaan. Dokumentasi memberikan contoh 4 pasangan trading × 10 order = 1 permintaan. Jika Anda menempatkan grid atau menyeimbangkan kembali buku, batching bukanlah optimasi mikro; itu adalah perbedaan 40× dalam throughput.
• Percobaan ulang dihitung. Backoff eksponensial yang mencoba ulang segera pada 429 akan membuat Anda tetap tercekik. Mundur dengan jitter, dan jatuhkan order basi daripada mengantrekannya.

Anggaran praktis: cadangkan sekitar 60–70% dari batas untuk aliran order, sisakan sisanya untuk polling saldo dan posisi, dan pindahkan apa pun yang Anda bisa ke WebSocket. Buku order dan data ticker melalui REST adalah alasan paling umum mengapa bot trading yang berperilaku baik akhirnya dibatasi kecepatannya.

Kesalahan domain dasar dan daftar putih IP yang salah

Dua kesalahan melaporkan diri mereka sendiri dengan cukup buruk sehingga layak mendapatkan bagiannya sendiri.

40102 Trading pair configuration does not exist pada pasangan yang dapat Anda lihat trading di situs biasanya bukan masalah simbol. WEEX membagi REST di https://api-spot.weex.com untuk spot dan https://api-contract.weex.com untuk kontrak. Simbol futures yang dikirim ke domain spot diselesaikan ke pasangan yang benar-benar tidak ada di domain itu, dan kesalahannya secara teknis akurat dan benar-benar menyesatkan. Periksa host sebelum Anda memeriksa simbol.

40018 Illegal IP request berarti IP panggilan tidak ada dalam daftar putih kunci. Bagian yang canggung adalah apa yang mengubahnya tanpa Anda sadari: penyedia cloud yang merotasi IP egress, failover gateway NAT, koneksi ulang VPN, atau alamat IPv6 yang digunakan saat Anda memasukkan IPv4 ke daftar putih. Panduan dukungan adalah bahwa Anda dapat membuat kunci yang tidak terikat ke alamat IP, dan untuk kunci data pasar hanya baca, itu adalah pertukaran yang masuk akal. Untuk kunci dengan izin trading atau penarikan, tidak — kunci trading yang tidak terikat adalah kredensial pembawa yang berfungsi dari mana saja di internet. Sematkan IP, dan pantau perubahan daripada menghapus kontrol.

Konteks yang lebih luas tentang bagaimana permukaan REST dan WebSocket cocok bersama dibahas dalam penjelas Wiki WEEX tentang apakah WEEX mendukung trading API.

Daftar periksa triase API WEEX 5 menit

Jalankan ini secara berurutan sebelum membuka tiket dukungan. Setiap langkah mengisolasi satu lapisan, dan kegagalan pertama memberi tahu Anda di mana harus berhenti mencari.

Jika setiap langkah lulus dan panggilan masih gagal, kode yang tersisa — 40013, 40015, 40409, 40725, 41101 — adalah kode yang diminta oleh dukungan WEEX secara eksplisit untuk Anda ajukan perintah kerja. Sertakan stempel waktu permintaan, endpoint, dan kode yang dikembalikan; ketiganya adalah apa yang membuat tiket dapat diselesaikan. Referensi resmi lengkap adalah daftar kode kesalahan API WEEX.

Apa yang kode kesalahan katakan tentang integrasi Anda

Peringkat kegagalan Anda berdasarkan lapisan, bukan berdasarkan frekuensi. Seratus 429 adalah masalah desain throughput yang dapat Anda atur dalam satu sore. Satu 40009 intermiten adalah bug penandatanganan yang akan menjatuhkan order secara diam-diam pada saat yang paling buruk, dan itu adalah satu-satunya yang layak diperbaiki terlebih dahulu. Integrasi yang tetap sehat pada API WEEX berbagi tiga kebiasaan: mereka menandatangani ulang setiap percobaan ulang, mereka tidak pernah mempercayai jam lokal, dan mereka mencatat permintaan kabel daripada permintaan yang mereka maksudkan untuk dikirim.

Siap membangun? Buat dan cakup kunci Anda di halaman API WEEX, mulai dengan kunci hanya baca terhadap endpoint publik, dan hanya tambahkan izin trading setelah daftar periksa triase Anda berjalan bersih dari awal hingga akhir.

FAQ

1. Apa arti kesalahan 40009 pada API WEEX?

API validation failed adalah ketidakcocokan tanda tangan jauh lebih sering daripada kunci yang buruk. Bangun ulang string prehash sebagai timestamp + METHOD + requestPath + "?" + queryString + body, konfirmasikan metodenya huruf besar, dan pastikan pustaka HTTP Anda tidak menyerialisasi ulang isi JSON setelah Anda menandatanganinya.

2. Mengapa permintaan API WEEX saya berfungsi secara lokal tetapi gagal dengan 40008 dalam produksi?

Hampir selalu drift jam host. Stempel waktu yang ditandatangani harus berada dalam 30 detik dari waktu server WEEX, dan container sering berjalan tanpa NTP. Sinkronkan jam host atau cache offset dari endpoint waktu server publik saat startup.

3. Berapa batas kecepatan API WEEX?

Defaultnya adalah 10 permintaan per detik kecuali endpoint menentukan sebaliknya, dihitung per kunci API untuk panggilan terautentikasi dan per IP publik untuk yang tidak terautentikasi, seperti yang didokumentasikan pada 27 Juli 2026. Melebihinya mengembalikan 429.

4. Bisakah saya menggunakan kunci API WEEX tanpa daftar putih IP?

Ya — dukungan WEEX menyarankan membuat kunci yang tidak terikat ke alamat IP saat 40018 Illegal IP request memblokir Anda. Cadangkan itu untuk kunci hanya baca. Kunci trading atau penarikan tanpa batasan IP berfungsi dari mana saja, yang merupakan penurunan keamanan yang berarti.

5. Mengapa saya mendapatkan 40102 untuk pasangan trading yang jelas ada?

Anda mungkin memanggil domain dasar yang salah. Permintaan spot pergi ke https://api-spot.weex.com dan permintaan kontrak ke https://api-contract.weex.com; simbol futures pada host spot menghasilkan kesalahan ini dengan tepat.

6. Apakah API WEEX sama dengan kerangka kerja Apache Weex?

Tidak. API bursa WEEX adalah antarmuka trading REST dan WebSocket. Apache Weex adalah kerangka kerja UI seluler yang dihentikan dengan kode kesalahan yang tidak terkait seperti -1001. Hasil pencarian untuk "weex api" mencampur keduanya.

Peringatan Risiko

Aset kripto tidak stabil, dan memperdagangkannya — secara manual atau melalui API WEEX — dapat mengakibatkan kerugian sebagian atau seluruh dana Anda. Trading otomatis menambahkan mode kegagalan yang tidak dimiliki trading manual: kode kesalahan yang tidak tertangani dapat membiarkan posisi terbuka atau terduplikasi, pembatalan yang dibatasi kecepatan dapat gagal sementara pengisian terus berlanjut, drift jam dapat menolak order pengurang risiko secara diam-diam, dan kunci API tanpa batasan IP atau batas cakupan adalah kredensial yang dapat digunakan penyerang dari mana saja. Trading futures di WEEX melibatkan leverage, yang memperbesar keuntungan dan kerugian serta dapat memicu likuidasi lebih cepat daripada bot dapat bereaksi. Uji dengan ukuran order legal terkecil, gunakan kunci hanya baca hingga penanganan kesalahan Anda terbukti, atur batas posisi dan kerugian di luar logika trading Anda, dan jangan pernah memberikan izin penarikan ke kunci yang tidak membutuhkannya. Tidak ada di sini yang merupakan saran investasi.