Penyambungan Kembali WebSocket WEEX: Memulihkan Pembaruan Order

By: WEEX
|
0

Penyambungan Kembali WebSocket WEEX: Memulihkan Pembaruan Order

Setelah koneksi WebSocket WEEX terputus, pulihkan koneksi privat dengan timestamp dan signature baru, berlangganan kembali ke orders, lalu konfirmasikan bahwa langganan berhasil. Setelah itu, gunakan kueri REST untuk menyelaraskan status order selama gangguan sebelum strategi kembali mengandalkan data tersebut.

Misalnya, order yang masih terbuka sebelum koneksi terputus mungkin sudah terisi sebelum koneksi tersambung kembali. Menerima pembaruan baru saja tidak memberi tahu semua yang terjadi selama jeda tersebut. Proses pemulihan perlu menangani koneksi sekaligus perbedaan antara catatan order lokal dan status akun sebenarnya.

Simpan informasi yang dibutuhkan untuk pemulihan

Pantau koneksi yang ditutup, kesalahan jaringan, dan kegagalan respons heartbeat. Saat terjadi gangguan, catat waktu penerimaan terakhir yang berhasil dan simpan ID order yang diketahui, ID order klien, serta status lokal. Informasi ini akan digunakan untuk mengueri order setelahnya.

Tandai status order sebagai menunggu rekonsiliasi dan jeda tindakan otomatis yang memerlukan gambaran lengkap agar dapat berjalan dengan aman. Sambungkan kembali dengan backoff yang dibatasi dan jitter agar worker tidak melakukan percobaan berulang secara bersamaan. Batas yang didokumentasikan mencakup 300 permintaan koneksi per IP setiap lima menit, hingga 20 koneksi bersamaan per IP, dan 240 operasi langganan per koneksi per jam. Tentukan pengaturan backoff dengan mempertimbangkan batas-batas tersebut.

Autentikasi ulang untuk koneksi privat yang tepat

Pembaruan order menggunakan kanal privat untuk produk terkait:

ProdukAlamat WebSocket privat
Spotwss://ws-spot.weex.com/v3/ws/private
Futureswss://ws-contract.weex.com/v3/ws/private

Handshake memerlukan User-Agent, ACCESS-KEY, ACCESS-PASSPHRASE, ACCESS-TIMESTAMP, dan ACCESS-SIGN. Gunakan timestamp dalam milidetik yang sesuai dengan nilai dalam signature. Dokumentasi menyebutkan bahwa timestamp tersebut kedaluwarsa setelah 30 detik, jadi buat autentikasi baru untuk setiap koneksi baru.

Pesan penandatanganan WebSocket adalah:

timestamp + "/v3/ws/private"

Terapkan HMAC-SHA256 dengan SecretKey, lalu enkode hasilnya dalam Base64 untuk ACCESS-SIGN. Format ini menggunakan format penandatanganan WebSocket, bukan konstruksi lengkap permintaan REST. Lihat dokumentasi WebSocket spot dan dokumentasi WebSocket futures untuk detail koneksi.

Berlangganan kembali ke orders dan periksa konfirmasinya

Kirim permintaan ini pada koneksi privat yang baru:

{"method":"SUBSCRIBE","params":["orders"],"id":1}

Referensi kanal order spot dan kanal order futures mencantumkan konfirmasi keberhasilan berikut:

{"result":true,"id":1}

Cocokkan respons dengan permintaan langganan melalui id, dan periksa msg jika gagal. Ini adalah ID permintaan, bukan ID order. Jika hanya mencatat “WebSocket terhubung”, Anda bisa melewatkan kondisi koneksi yang berhasil tetapi diikuti oleh langganan yang gagal.

Koneksi ini juga memerlukan penanganan heartbeat tingkat aplikasi WEEX. Ping privat ditampilkan sebagai {"type":"ping","time":"1693208170000"}; kanal publik menggunakan event. Respons yang didokumentasikan adalah:

{"method":"PONG","id":1}

Penanganan ping dan pong tingkat protokol oleh suatu library tidak menggantikan pemrosesan pesan JSON ini. Dokumentasi menyebutkan bahwa server akan memutus koneksi setelah lebih dari 10 ping tidak dijawab, tetapi tidak memberikan interval heartbeat universal yang dapat digunakan untuk menghitung waktu pemutusan tetap.

Lakukan rekonsiliasi melalui REST, termasuk order yang tidak lagi terbuka

Saat peristiwa order masuk kembali, simpan sementara peristiwa tersebut sambil mengueri order terbuka, riwayat order, dan detail order yang diketahui. Bandingkan status, akumulasi pengisian, dan waktu pembaruan. Ini adalah pendekatan pemulihan di sisi klien untuk perubahan yang mungkin terlewat selama gangguan; jangan berasumsi bahwa server memutar ulang semua pesan historis.

Informasi yang perlu direkonsiliasiPath GET spotPath GET futures
Order terbuka/api/v3/openOrders/capi/v3/openOrders
Riwayat order/api/v3/allOrders/capi/v3/order/history
Detail order individual/api/v3/order/capi/v3/order

Kueri order terbuka saja melewatkan satu kasus penting: order yang terisi atau dibatalkan selama jeda mungkin sudah tidak muncul di sana. Karena itulah riwayat order dan detail untuk order yang diketahui perlu disertakan dalam proses pemulihan.

Tangani rentang waktu, kolom wajib, dan paginasi setiap endpoint. Contohnya, Spot allOrders mewajibkan symbol, sedangkan riwayat futures menyediakan page dan limit. Ikuti aturan riwayat spot dan riwayat futures untuk mengambil catatan yang relevan sebelum menggabungkan peristiwa yang disimpan sementara.

Peristiwa duplikat tidak boleh memicu tindakan akuntansi atau bisnis berulang, dan peristiwa yang lebih lama tidak boleh menimpa status terbaru yang telah dikonfirmasi. Lakukan kueri lagi saat pembaruan REST dan stream tidak sesuai. Kolom pesan v didefinisikan sebagai versi akun; dokumentasi tidak menjamin adanya urutan order yang berkesinambungan atau kursor pemutaran ulang. Karena itu, celah versi saja tidak dapat menunjukkan adanya order yang hilang.

Jika pembaruan tetap tidak masuk, ikuti gejalanya

GejalaHal yang perlu diperiksa
Handshake mengembalikan 403Periksa User-Agent, lalu kolom autentikasi lainnya. FAQ resmi menyebutkan bahwa firewall memblokir koneksi yang tidak menyertakan header tersebut.
Koneksi berhasil, tetapi tidak ada konfirmasi langganan yang berhasilVerifikasi alamat privat, permintaan orders, serta kesalahan apa pun dalam konfirmasi.
Sudah berlangganan, tetapi tidak ada peristiwa order baruPeriksa heartbeat dan aktivitas akun yang sebenarnya. Stream yang sepi dapat terjadi jika tidak ada perubahan order baru.
SDK telah tersambung kembali, tetapi status lokal masih berbedaPeriksa rekonsiliasi REST selama jeda. Penyambungan kembali otomatis tidak memastikan status order telah direkonsiliasi.

Selama proses pemulihan, jangan menganggap respons yang tidak muncul sebagai bukti bahwa order gagal, lalu mengirim ulang setiap order. Pastikan status akun sebenarnya, selesaikan perbedaannya, lalu lanjutkan kembali strategi yang bergantung padanya.

Untuk bantuan lebih lanjut, gunakan tautan dukungan di FAQ API resmi dan berikan waktu koneksi, kode status, serta log yang telah disamarkan untuk menunjukkan titik terhentinya proses pemulihan.

Artikel terkait
Bagikan
copy

Gainer

iconiconiconiconiconiconiconicon
Dukungan Pelanggan:@weikecs
Kerja Sama Bisnis:@weikecs
Trading Kuantitatif & MM:bd@weex.com
Program VIP:support@weex.com