Hata Kodları ve Sorun Giderme

Markdown olarak görüntüle

Hata Yanıt Formatı

1{
2 "code": 1003,
3 "message": "Invalid token",
4 "requestId": "req-12345678"
5}

İş hataları genellikle yine de birleşik JSON yapısını geri döndürür. Entegratörler önce code kontrol etmeli. Kimlik doğrulama hataları HTTP 401döndürebilir; Hız sınırı HTTP 429geri getirebilir.

Yaygın Hata Kodları

Hata koduTanım
0Başarı
1001Geçerli kimlik doğrulama bilgisi sağlanmadı
1002Token süresi doldu
1003Geçersiz Token, API Keyveya imza
1004Token iptal edildi
1006Kaynak IP uyumsuzluğu
2001Eksik gereken parametre
2002Geçersiz parametre değeri
2003Aralık dışı parametre
3001Yetersiz denge
3003Emir bulunamadı
3004Tekrarlanan talep
3005Sipariş iptal edilemez
3006İzin reddedildi
3100 - 3112Şart sırası parametre doğrulama hatası
5001Dahili sunucu hatası
5002Hizmet geçici olarak kullanılamaz
5003Hız sınırı tetiklendi

Sorun Giderme

SorunTavsiye
1001 geçerli kimlik doğrulama bilgisi yokAuthorization: Bearer <accessToken> veya X-API-KEY dahil olup olmadığını kontrol edin.
1002 Token süresi dolduToken’ı yenile veya tekrar giriş yapmadan önce tekrar giriş yapın.
1003 geçersiz Token, API Keyveya imzaAPI Key, imza yükü, istek gövdesi JSON dizisi ve sorgu parametre sırasını kontrol edin.
1006 kaynağı IP uyumsuzlukAPI Key IP beyaz listesi yapılandırmasını kontrol edin.
3004 tekrarlayıcı talebiAynı imzayı siparişle ilgili yollar için tekrar kullanmayın. timestamp yeniden yarat ve signature.
5003 hız sınırı tetiklendiTekrar denerken istek sıklığını azaltın ve üstel geri çekme kullanın.
Timestamp outside of tolerance windowZaman ofsetini kalibre etmek ve talebi tekrar imzalamak için /v1/time ‘yi arayın.