API kullanımına ilişkin sıkça sorulan soruların yanıtları

S1: Adresi beyaz listeye eklemiş olmama rağmen neden hâlâ para çekemiyorum?

Neden:
1. Çekim sayfasındaki beyaz liste ile API çekim beyaz listesi birbirinden bağımsızdır.
2. [Çekim Sayfası] > [Çekim Adresi Yönetimi] üzerinden eklenen adresler API üzerinden yapılan çekimler için geçerli değildir.

Çözüm:

1. API Çekim Beyaz Listesi Yönetim Sayfasını ziyaret edin: https://www.coinex.com/apikey
2. Çekim adresini API'ye özel beyaz listeye ekleyin.

S2: 'access_id not exist' Hatası

Yaygın Nedenler:

(1) Yeni oluşturulan API anahtarlarının aktif hâle gelmesi yaklaşık 10 dakika sürebilir. Oluşturulduktan hemen sonra API çağrısı yapmak bu hataya yol açabilir.

(2) access_id yanlış olabilir.

(3) İmza doğrulaması geçersiz olabilir.

(4) İstek başlığı hatalı olabilir.

Çözüm:

(1) HTTP kimlik doğrulama isteğinin nasıl oluşturulacağını öğrenmek için [CoinEx API Dokümantasyonu] bölümünü inceleyin.

(2) Demo:

S3: '3008/4001 service unavailable' Hatası

Neden: 

Bu hata, sunucu yükünün yüksek olduğu dönemlerde emir iptal edilirken ortaya çıkabilir.

Çözüm:
(1) Öncelikle önemli emirleri iptal etmeye öncelik verin.
(2) 1-2 saniye bekledikten sonra işlemi yeniden deneyin.
(3) Yanıt kodu 0 ise ancak emir iptal olmamışsa:

• Tam istek ve yanıtı kaydedin.
• Müşteri destek ekibimizle iletişime geçin ve yardım alabilmeniz için ana/alt hesap bilgilerini iletin.

S4: Geçersiz Parametre Hatası

Neden: 
Bu hata genellikle gönderilen parametrelerin API dokümantasyonunda belirtilen türlerle uyuşmaması durumunda ortaya çıkar.

Çözüm: 
POST /spot/cancel-order uç noktasını örnek olarak alırsak:

(1) Parametre adlarını ve türlerini API dokümantasyonundaki bilgilerle dikkatlice karşılaştırın.

(2) Tam sayı (int) ve dize (string) türleri arasındaki farklara özellikle dikkat edin.

S5: API hız limitleri nelerdir?

Hız limitleri, Yanıt Başlığı üzerinden tespit edilebilen kısa vadeli hız limitleri ve uzun vadeli hız limitleri olarak ikiye ayrılır:

1. Kısa Vadeli Hız Limitleri: X-RateLimit-Limit değeri 0'dan büyükse kısa vadeli hız limiti tetiklenmemiştir.

Kısa vadeli hız limiti, ana hesap ve alt hesap için ayrı limitlere sahip bir token bucket mekanizması kullanır.

• Tetikledikten sonra yaygın hata: 
  - Kod: 213, 4213

- Mesaj: Please don't try too frequently.

2. Uzun Vadeli Hız Limitleri: Yanıt Başlığında X-RateLimit-LongPeriod-{period}-Remaining döndürülüyorsa uzun vadeli hız limitleri tetiklenmiştir. Sistem, kullanıcının istek hacmini ve istek kalitesini değerlendirerek uzun dönem toplam istek sayısına sınırlama getirip getirmeyeceğine karar verir. Uzun vadeli hız limiti tetiklendiğinde, tüm uç noktalar için istek oranları (emir iptali hariç) saniyede 1 isteğe düşürülür.

• Yaygın hata: 

- Kod: 213, 4213

- Yanıt Başlığı üzerinden ek değerlendirme yapılması gerekir..

Diğer Yaygın Sorular

S1: API istek gecikmesi nasıl azaltılır?

Sunucular AWS Tokyo bölgesinde konuşlandırılmıştır ve bölgeler arası yük dengelemeyi destekler. Gecikmeyi en aza indirmek için size en yakın bölgeyi seçebilirsiniz.

Kullanılabilir bölgeler:

• ap-northeast-1a
• ap-northeast-1c
• ap-northeast-1d

S2: API çekimleri için 2FA gerekli mi?

Güvenlik nedenleriyle:

1. API çekimlerini kullanmadan önce 2FA ile giriş yapmanız ve yetkilendirmeniz gerekir.

2. Çekim adreslerini [Çekim Beyaz Listesi]'ne ekledikten sonra, daha fazla 2FA doğrulaması olmadan API çekimi başlatabilirsiniz.

S3: Çekim beyaz listesi adresleri API aracılığıyla eklenebilir mi?

Şu anda API üzerinden çekim beyaz listesi adresi ekleme desteklenmemektedir. Lütfen adresleri manuel olarak veya toplu şekilde eklemek için [API Yönetimi] > [Çekim Beyaz Listesi] bölümüne gidin.

S4: 'Signature incorrect' Hatası

Çözümler:

1. access_id ve secret_key'in doğru yapılandırıldığını kontrol edin.

2. İstek gövdesi ile imza oluşturmak için kullanılan parametrelerin aynı olduğundan emin olun. Parametreleri dize formatında önceden işleyin ve imzalamadan önce ve sonra tutarlılığı doğrulayın.

3. İmzalama için üçüncü taraf bir kütüphane kullanıyorsanız doğru yapılandırıldığından emin olun.

S5: 'Tonce check error - Correct tonce should be within one minute of the current time' Hatası

Çözüm:

(1) Tüm API isteklerinde zaman damgasının milisaniye cinsinden olduğundan emin olun.

Örnek:

(2)  Bilgisayarınızda otomatik zaman senkronizasyonunun etkin olduğundan emin olun.

S6: Vadeli işlemler hesabının gerçek kullanılabilir bakiyesi ve net değeri nasıl alınır?

(1) Vadeli işlemler hesabının mevcut kullanılabilir bakiyesini almak için /assets/futures/balance uç noktasını kullanın.

(2) API uç noktaları şu anda hesabın net değerini döndürmeyi desteklememektedir. Net değer, gerçekleşmiş ve gerçekleşmemiş kâr/zararın toplamıdır.

(3) Gerçekleşmemiş kâr/zarar sabit bir değer değildir ve pozisyon değiştikçe dalgalanır. Kesin sonuç için manuel hesaplama gereklidir.

(4) Hesaplama formülleri için "Doğrusal Sözleşme Hesap Geliri ve Kâr/Zarar Nasıl Hesaplanır?" dokümantasyonuna bakın.

S7: WebSocket API tarafından döndürülen veriler nasıl işlenir?

WebSocket API, sıkıştırılmış JSON dize formatında veri döndürür. Bu veriler kullanılmadan önce açılmalıdır (örneğin gzip modülü kullanarak).

Yaygın Hata:

utf-8 codec can't decode byte 0x8b in position 1: invalid start byte

S8: Üçüncü taraf vergi platformu hata bildirirse ne yapmalı?

V1 hizmetleri 25 Eylül 2024 tarihinde sonlandırılmıştır. Hata, platformun kodlarını V2'ye yükseltmemiş olmasından kaynaklanabilir. Lütfen destek için ilgili vergi platformuyla iletişime geçin.

S9: Başarılı bir WebSocket bağlantısı nasıl doğrulanır?

Başarılı bir abonelik sonrasında bir abonelik yanıtı alırsınız.

Ardından abone olduğunuz kanal için mesaj güncellemeleri gelir:

S10: WebSocket bağlantısı neden otomatik olarak kesiliyor? Bağlantı nasıl sürdürülebilir?

(1) WebSocket bağlantısının kesilmesi genellikle ağ sorunlarından kaynaklanır. Lütfen ağ bağlantınızın stabil olup olmadığını kontrol edin.

(2) WebSocket bağlantısını aktif tutmak için server.ping kullanarak bağlantıyı canlı tutmanız gerekir.

(3)  Sunucu ile 1 dakika boyunca iletişim olmazsa WebSocket bağlantısı otomatik olarak kesilir. Bağlantının kopmaması için ping arayüzü üzerinden 60 saniyeden kısa bir gönderim aralığı ayarlamanız önerilir.

Diğer API hataları için lütfen BURAYA TIKLAYARAK müşteri destek ekibimizle iletişime geçin ve sorunu çözmeye yardımcı olmak için aşağıdaki bilgileri iletin:

(1) Ana hesabın e-postası veya alt hesabın kullanıcı adı

(2) Tam istek ve yanıt detayları

Önemli: Gereksiz kayıpları önlemek için hata mesajlarında access_id ve secret_key'i PAYLAŞMAYIN.