SDK Entegrasyon Sorunlarını Giderme

Başarısız işlemin ortamı, zaman damgası ve iş tanımlayıcısıyla başlayın. Yapılandırılmış bir kontrol genellikle yapılandırma sorunlarını kimlik doğrulama, ağ ve eşzamansız işleme sorunlarından ayırır.

Önerilen teşhis sırası

Etkilenen ortamı ve tabanı URL doğrulayın.
UTC zaman aralığını ve ilk başarısız isteği kaydedin.
Modülü tanımlayın: Trading Widget, Agent SDK, REST API, WebSocket veya webhook.
İstek kimliğini, iş ortağı kullanıcı kimliğini, agentOrderNo, sipariş kimliğini veya webhook olay kimliğini yakalayın.
En son kodu, kimlik bilgilerini, IP beyaz listeyi veya dağıtım değişikliklerini kontrol edin.
En küçük güvenli test durumuyla çoğaltın.

Belirti	Muhtemel sebep	Düzeltmek
iframe, iş ortağının yerel alan adını ister	baseUrl eksik	baseUrl iletin: ‘https://app.6mm.com’.
iframe görünmez veya çok kısa	Ana kabın yüksekliği yok	Konteyner yüksekliğini veya geçiş yüksekliğini ayarlayın.
token_provider_missing	iş ortağı belirteci modunun sağlayıcısı yok	Kimlik doğrulama ekletokenProvider.
auth_exchange_failed	Geçersiz, süresi dolmuş veya eşleşmeyen yerleştirme jetonu	Arka uç jeton yanıtını ve channelId kontrol edin.

Agent SDK sorunlar

Belirti	Muhtemel sebep	Düzeltmek
İmza reddedildi	Yanlış sır, saat kayması veya imzalı alanların manuel olarak değiştirilmesi	SDK’in imzalama alanları oluşturmasına ve sunucu zamanını senkronize etmesine izin verin.
Yinelenen fon hareketi riski	Zaman aşımından sonra kullanılan yeni sipariş numarası	Önce orijinal agentOrderNo ile sorgulayın.
PROCESSING başarısızlık olarak değerlendirildi	Bekleme durumu yanlış anlaşıldı	webhook bekleyin veya queryOrder’i arayın.
Webhook birden çok kez işlendi	İdempotans olmadan davranışı yeniden dene	Bağımsızlık anahtarı ve son durum kontrollerini ekleyin.

Yakalanacak kanıt

Entegrasyon	Yararlı kanıtlar
Trading Widget	Sayfa URL, SDK sürüm yolu, tarayıcı konsolu, başarısız ağ istekleri, `onError` yükü ve kapsayıcı boyutları.
Agent SDK	SDK dil/sürüm, temel URL, UTC zaman damgası, istek kimliği, `agentOrderNo`, yanıt kodu ve temizlenmiş günlükler.
Webhook	Teslim süresi, olay veya iş anahtarı, imza doğrulama sonucu, işleme durumu ve sterilize edilmiş ham gövde karması.
REST API	Yöntem, yol, ortam, istek kimliği, yanıt kodu ve arındırılmış parametreler.

Tanılamaya hiçbir zaman parolaları, erişim belirteçlerini, API sırları, tam imzaları, özel anahtarları veya düzenlenmemiş kişisel verileri dahil etmeyin.

Sorunu tırmandırmadan önce

Yalnızca işlemin yeniden denemenin güvenli olduğu belgelendiğinde yeniden deneyin.
Zaman aşımından sonra yeni bir işletme tanımlayıcısı oluşturmak yerine orijinal işletme tanımlayıcısını sorgulayın.
İmza hataları için sistem saatini ve kimlik bilgisi ortamını doğrulayın.
İlk başarısızlığı ve daha sonraki yeniden deneme sonuçlarını koruyun.
Kullan Destek Talebi Şablonu Tam, düzeltilmiş bir rapor göndermek için.

İlgili dokümanlar

Trading Widget Hızlı Başlangıç

Komut dosyası yüklemesini, kapsayıcı boyutunu, yapılandırmayı ve geri aramaları doğrulayın.

Sırlar ve İmzalama

Agent SDK kimlik bilgilerini, saatleri ve imzalı alanları kontrol edin.

Webhooks ve İdempotans

Geri arama doğrulamasını ve yinelenen olay işlemeyi gözden geçirin.

Java v0.3.0 teşhisi

Belirti	Kontrol ve kurtarma
Finansman isteğinin bilinmeyen bir sonucu var	Orijinali saklayın `agentOrderNo`; orijinal ortamla `queryWalletTransfer`’i arayın. `queryOrder` kullanmayın.
Simülasyon kullanıcı arayüzü beklenmedik fonları gösteriyor	Ön ucu `tradingMode` arka uçtan `environment` ayrı olarak kontrol edin; `isSimulatedUser` hesabı istekleri yönlendirmiyor.
Sorgu hatası `6905`	Paylaşılan ortak kotasını kullanarak geri çekilin, ardından aynı imleci yeniden deneyin ve SDK üzerinden filtreleyin.
Sorgu hatası `6904`	Eş zamanlı sorguları azaltın ve zaman penceresini daraltın; ısrar ederse desteğe başvurun.
Geçersiz veya süresi dolmuş imleç	Aynı sabit geçmiş penceresini yeniden başlatın ve kayıtlı kayıtları tekilleştirin.
Yeni Java yöntemi eksik	Çözülmüş Maven yapıtını genel etiket `v0.3.0` ile karşılaştırarak kontrol edin; yapı politikanıza göre çakışan bağımlılıkları kaldırın.

Sorgu ve hata referansı · Yükseltme kılavuzu

Webhook alma sorunları

Belirti	Kontrol ve kullanım
Başarısızlık döndürüldükten sonra yeniden deneme yok JSON	Uç noktanın hala HTTP 200 döndürüp döndürmediğini kontrol edin. Teslimat, gövdedeki bir başarı göstergesini değil, yalnızca HTTP durumunu kullanır.
Yeniden denemeler 401 veya 409’dan sonra devam ediyor	2xx olmayan yanıtlar mevcut yeniden deneme ilkesine uyar; imzaları, bildirim içeriğini veya satıcı yapılandırmasını araştırın.
Tasfiye uyarısı için boş idempotency anahtarı	Mevcut `WebhookVerifier.idempotencyKey` yalnızca fon-etkinlik kimliklerini çıkarır. İmza ve sahiplik kontrollerinden sonra, `notificationId` doğrulayın ve satıcı kodunda uyarı anahtarını oluşturun. Asla boş bir anahtar kullanmayın.
Başarılı işlemden sonra yinelenen bildirim	Satıcı ve `environment` kapsamında tekilleştirmeye devam edin. Aynı kopyalar için 2xx değerini döndürün; çakışmaları kaydedin ve aynı kimlik için farklı bir gövdeyle 2xx olmayanı döndürün.
Uyarı işlenmedi	`liquidation.warning` ve geçmiş `LIQUIDATION_WARNING`’i kabul edin; Farklı bildirim kimliklerini kullanıcıya, bölüme veya etkinlik türüne göre gruplandırmayın ve bunları atmayın.
Kabul edilen bildirim, bekleyen görevini kaybeder	2xx’i döndürmeden önce görevi güvenilir bir şekilde kaydedin; bellek içi eşzamansız bir görevin başlatılması yetersizdir.

Etkinlik alanları ve uyumluluk · HTTP yanıtlar ve güvenilir onay