Membetulkan ralat sambungan API key exchange

Apabila anda menambah API key exchange, Freya memeriksanya sebelum menyimpan — dan jika ada yang tidak kena, Freya memberitahu anda apa yang perlu dibetulkan. Panduan ini membantu anda membaca keputusan tersebut dan membetulkannya. (Jika key anda sudah tersambung dengan baik tetapi sesuatu bot kemudiannya berhenti, itu masalah yang berbeza — lihat Mengapa Bot Saya Terjeda atau Berhenti?.)

Untuk langkah persediaan kali pertama, mulakan dengan Cara Menyambungkan Exchange Anda; artikel ini adalah tentang apa yang perlu dilakukan apabila sambungan tersebut gagal.

Apabila Key Tidak Mahu Tersambung

Menambah key bukan penyimpanan membuta tuli — Freya mengesahkan key berfungsi dan mempunyai kebenaran yang betul sebelum ia disimpan secara tersulit. Jika ada yang tidak kena, ralat mengarahkan anda terus kepada puncanya — biasanya key atau secret, sekatan IP, atau kebenaran yang hilang. Bahagian di bawah menelusuri setiap ralat dan cara membetulkannya.

"Invalid API Key" atau "Invalid Secret Key"

Ralat sambungan yang paling biasa, dan biasanya yang paling mudah:

• Tersilap salin/tampal — ruang kosong yang terselit atau aksara yang hilang. Salin semula key dan secret dengan teliti.
• Secret hanya ditunjukkan sekali sahaja. Exchange mendedahkan secret key satu kali sahaja apabila anda menciptanya. Jika anda tidak menyimpannya, anda tidak boleh memulihkannya — cipta key baharu.
• Key telah dipadam atau dijana semula di exchange, jadi ia tidak lagi sepadan.

Betulkan: masukkan semula key dan secret dengan tepat, atau cipta key baharu dan cuba lagi.

Ralat Sekatan IP

Freya tersambung dari pelayannya sendiri, jadi tetapan IP pada key adalah penting. Terdapat dua kes yang berbeza:

• "IP Not Whitelisted" — key anda disekat mengikut IP, tetapi alamat pelayan Freya tiada dalam senarai benarnya. Skrin Add API Key menunjukkan alamat IP yang perlu ditambah (dengan butang salin) — tambah alamat tersebut ke whitelist key di exchange.
• "Unrestricted" — key anda tiada sekatan IP langsung. Demi keselamatan anda, Freya meminta anda untuk menghidupkan sekatan IP dan menambah alamat yang ditunjukkannya, kemudian cuba lagi.

Dalam kedua-dua kes, idea pembetulannya sama: hadkan key kepada IP yang dipaparkan Freya dalam modal.

Ralat Kebenaran

Key tersambung, tetapi ia tidak dapat melakukan apa yang bot anda perlukan:

• Baca dinyahdayakan — dayakan kebenaran baca/lihat pada key.
• Kebenaran dagangan hilang — dayakan dagangan (spot dan/atau futures, sepadan dengan bot anda).
• Ketidaksepadanan Spot vs Futures — bot futures memerlukan key dengan dagangan futures didayakan; bot spot memerlukan dagangan spot. Jika anda menambah key spot sahaja untuk bot futures (atau sebaliknya), Freya menandakannya. Pastikan pasaran yang didayakan pada key sepadan dengan bot yang anda bina.

Ingat: Freya hanya sekali-kali memerlukan kebenaran baca dan dagangan — jangan sekali-kali pengeluaran. Key tanpa kebenaran pengeluaran itulah tepatnya yang anda mahukan.

Perkara Khusus Setiap Exchange

• OKX memerlukan passphrase. Apabila anda mencipta key OKX, anda menetapkan passphrase — masukkan passphrase yang sama itu di Freya, tepat seperti yang anda tetapkan. Passphrase yang salah adalah punca kegagalan sambungan OKX yang biasa.
• Persediaan futures OKX. Dagangan futures OKX memerlukan mod akaun tertentu, yang disediakan Freya untuk anda secara automatik — anda tidak perlu mengkonfigurasinya secara manual.
• Mod hedge (futures). Freya menggunakan mod hedge untuk akaun futures. Jika anda sudah mempunyai posisi one-way terbuka yang bercanggah, anda mungkin melihat amaran dan bukannya kegagalan — key tetap tersimpan, dan bot anda boleh berdagang setelah posisi sedia ada tersebut ditutup.
• Binance dan Bybit tidak menggunakan passphrase — tiada medan passphrase untuk kedua-duanya.

"Connection Failed" Tanpa Sebab yang Jelas

Kegagalan sambungan yang umum selalunya bukan salah anda — gangguan rangkaian seketika atau exchange yang sibuk sebentar. Tunggu sekejap dan cuba lagi. Jika ia terus gagal selepas beberapa percubaan, periksa semula tetapan key/secret dan IP di atas.

Masih Buntu? Senarai Semak Pantas

1. Cipta semula key di exchange dengan baca + dagangan sahaja (jangan sekali-kali pengeluaran).
2. Hadkan ke IP yang Freya tunjukkan di skrin Add API Key.
3. Sepadankan pasaran — key spot untuk bot spot, key futures untuk bot futures.
4. OKX: masukkan passphrase yang tepat.
5. Masih gagal? Hubungi [email protected].

Soalan Lazim

Freya kata "Invalid API Key" tetapi saya pasti saya menyalinnya dengan betul — apa yang salah?

Biasanya aksara tersembunyi atau ruang kosong terselit ke dalam key atau secret, atau key dijana semula/dipadam di exchange jadi ia tidak lagi sepadan. Salin semula kedua-dua medan dengan teliti, dan ingat secret hanya ditunjukkan sekali sahaja semasa penciptaan — jika anda tidak memilikinya, cipta key baharu.

Apakah perbezaan antara "IP Not Whitelisted" dan "Unrestricted"?

"IP Not Whitelisted" bermaksud key anda disekat mengikut IP tetapi alamat pelayan Freya belum dibenarkan lagi — tambah alamat yang Freya tunjukkan ke whitelist key. "Unrestricted" bermaksud key tiada sekatan IP langsung; demi keselamatan, Freya meminta anda menghidupkan sekatan IP dan menambah alamatnya sebelum menyimpan.

Key OKX saya tidak mahu tersambung — adakah saya perlukan passphrase?

Ya. Key OKX mempunyai passphrase yang anda tetapkan semasa mencipta key. Anda mesti memasukkan passphrase yang tepat itu di Freya — passphrase yang salah atau hilang adalah punca kegagalan sambungan OKX yang biasa. Binance dan Bybit tidak menggunakannya.

Freya kata key saya tidak boleh membuat dagangan — bagaimana saya membetulkannya?

Key anda tidak mempunyai dagangan yang didayakan untuk pasaran yang digunakan bot anda. Di exchange, dayakan kebenaran dagangan — dagangan spot untuk bot spot, dagangan futures untuk bot futures — kemudian sambung semula. Freya memerlukan kebenaran baca dan dagangan, jangan sekali-kali pengeluaran.

Key futures saya memerlukan persediaan tambahan (mod akaun / mod hedge) — adakah itu masalah?

Tidak. Dagangan futures memerlukan mod akaun dan mod hedge tertentu, yang disediakan Freya untuk anda secara automatik. Jika anda mempunyai posisi one-way sedia ada, anda mungkin melihat amaran mod hedge dan bukannya ralat — key tetap tersimpan, dan bot anda boleh berdagang setelah posisi tersebut ditutup.

Saya menambah key spot tetapi bot futures saya tidak mahu menggunakannya (atau sebaliknya) — mengapa?

Sebuah key didayakan untuk pasaran tertentu. Bot futures memerlukan key dengan dagangan futures didayakan, dan bot spot memerlukan dagangan spot. Jika kedua-duanya tidak sepadan, Freya menandakannya. Sambungkan key yang pasaran didayakannya sepadan dengan bot yang anda cipta.

Sambungan hanya "gagal" tanpa sebab yang jelas — adakah ia daripada saya atau exchange?

Selalunya ia gangguan rangkaian atau exchange seketika dan bukannya tetapan anda. Cuba lagi sebentar kemudian. Jika ia terus gagal, periksa semula key dan secret untuk ralat penyalinan dan sahkan sekatan IP sepadan dengan alamat yang Freya tunjukkan.