Gezinmeye atla
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK v0.3.0 entegrasyonu, örnekler, parametreler ve yanıt semantiği.

Markdown olarak görüntüle

Bu kılavuz Agent Java SDK v0.3.0, Java 8+ ve etiketli kamu sözleşmesini hedefler. Örnekler, client başlatıldıktan sonra bir iş ortağı arka ucunda çalıştırılır. Hızlı Başlangıç.

Belgelendirme temeli: SDK v0.3.0, 54aa3c1 işlemini gerçekleştirin. Webhook alma kurallarına ek olarak uyulur WEBHOOKS.md, fa6c7b6’de; bu, uyarı yardımcı yöntemleri içeren yeni bir SDK yapısı olmayan, yalnızca belgeleme amaçlı bir güncellemedir.

Sürüm ve kurulum

ÖğeDeğer
Kararlı kaynak etiketiv0.3.0
JavaJava 8+
MavenMaven 3.9+
Koordinatlarcom.sixmm.exchange.sdk:agent:0.3.0

GitHub ana bilgisayar kaynağı; bu koordinatları Maven Central’dan çözülebilir hale getirmez. Etiketli yerel kurulumu veya onaylı yapı deponuzu kullanın.

SDK Neleri Kapsıyor

KategoriSenaryoSDK APITanım
Kullanıcı bağlamaKullanıcıyı bağlabindBir iş ortağı kullanıcısı ile 6MM platform kullanıcısı arasındaki bağlantıyı oluşturun veya getirin
Varlık sorgularıİş ortağı hesabını sorgulaqueryAccountİş ortağı marjını veya finansman hesabını sorgulayın
Varlık sorgularıKullanıcı varlıklarını sorgulaqueryUserAssetsSözleşme varlıklarını sorgulayın; Finansman bakiyelerini dahil etmek için withFunding() kullanın
TransferlerSabit tutar transferitransfer6MM içine veya dışına para aktarın
TransferlerHepsini aktartransferAllOutTüm çekilebilir kullanıcı bakiyesini ortak platformuna geri taşıyın
TransferlerTers sırareverseArka uç bir telafi akışını desteklediğinde başarılı bir aktarımı tersine çevirin
TransferlerSorgu sırasıqueryOrderİş ortağı sipariş numarasına göre bir transfer emrini sorgulama
TransferlerSiparişleri listelelistOrdersMutabakat için transfer emirleri arasında geçiş yapın
Webhookİmza doğrulamaWebhookVerifier.verifyHam fon olayını ve tasfiye uyarı organlarını doğrulayın; tüccar kodu zaman, sahiplik ve kalıcı veri tekilleştirme kontrollerini yönetir. Görmek Webhook Etkinlikler ve Tasfiye Uyarıları.
Finansman cüzdanıFinansman transferiwalletTransferOrtak ↔ Finansman veya Finansman ↔ Sözleşme; iade durumunu onayla
Finansman cüzdanıFinansman transferi durumuqueryWalletTransferOrijinal iş ortağı sipariş numarasını kullanarak bir Finansman işlemini kurtarma
Ticaret girişiDoğrudan giriş URLcreateEntryUrlYönlendirme modu için bir kerelik SSO URL oluşturun
Ticaret girişiBelirteci yerleştircreateEmbedTokenTrading Widget tokenProvider modu için kısa ömürlü bir belirteç oluşturun
Kalıcı verilerMevcut sürekli siparişlerlistCurrentPerpetualOrdersMevcut NORMAL veya CONDITIONAL siparişlerini sorgula
Kalıcı verilerSürekli sipariş geçmişilistPerpetualOrderHistoryTerminal NORMAL veya CONDITIONAL siparişlerini sorgula
Kalıcı verilerSürekli işlemlerlistPerpetualTradesAçık bir genel oyuncu listesi için sorgu ticareti doldurmaları
Kalıcı verilerMevcut kalıcı pozisyonlarlistCurrentPerpetualPositionsMevcut pozisyonları sorgula
Kalıcı verilerSürekli konum geçmişilistPerpetualPositionHistoryKapalı pozisyonları sorgula
Kalıcı verilerSürekli hesap defterilistPerpetualLedgerBireysel Sözleşme bakiyesi değişiklik kayıtlarını sorgulama
Fiat referans oranlarıDesteklenen fiat para birimlerini listeleyinlistSupportedFiatCurrenciesŞu anda USDT’a dönüştürülebilen fiat para birimlerini listeleyin
Fiat referans oranlarıDöviz referans oranlarını sorgulamaqueryExchangeRatesTüm veya seçilen para birimleri için günlük fiat-USDT referans oranlarını sorgulayın
Servis bilgileriHizmet sürümüversionAracı hizmeti sürüm bilgilerini sorgulama

Yapılandırma

Aşağıdaki değerleri önce 6MM’den alın entegre.

ÖğeÖrnekTanım
baseUrlhttps://agent-api.6mm.comAjan API tabanı URL, sonunda eğik çizgi olmadan
agentCodeAGENT001İş ortağı kodu
apiSecretyour-api-secretAPI imzalama sırrı. Yalnızca arka uçta tutun
defaultCurrencyUSDTVarsayılan para birimi, genellikle USDT
webhookUrlhttps://partner.example.com/6mm/webhookDört etkinlik türünün tümü tarafından paylaşılan satıcı geri araması URL; ayrı bir uyarı olmadan URL kuruluşu tarafından gönderim event.

Üretim önerileri:

  • Aracı API ve webhook uç noktaları için HTTPS kullanın.
  • apiSecret’ı bir gizli yöneticide, yapılandırma merkezinde veya ortam değişkeninde saklayın.
  • Sunucu zamanını tercihen NTP ile senkronize tutun.
  • Tüm iş ortağı sipariş numaralarını koruyun ve bunları dünya çapında benzersiz tutun.
  • Tarayıcılara, uygulamalara, mini programlara veya ön uç kaynak koduna asla apiSecret göndermeyin.

Otomatik İmzalama Alanları

İmzalı Temsilci API çağrıları için, SDK otomatik olarak şunu enjekte eder:

AlanKaynakTanım
agentCodeAgentClientConfig.agentCodeİş ortağı kodu
timestampGeçerli UTC Unix zaman damgasıSaniye
nonceGüvenli rastgele oluşturucuTekrar koruması
signHMAC-SHA256İmza iste
currencydefaultCurrencyTransfer/hesap isteklerinde para birimi çıkarıldığında doldurulur

İmza kuralları:

  1. sign’ı hariç tut.
  2. Boş değerleri hariç tutun.
  3. Anahtarları ASCII sırasına göre sıralayın.
  4. k=v&k2=v2 olarak katılın.
  5. HMAC-SHA256 hex’i apiSecret ile hesaplayın.

Dizi değerleri, imzalama yüküne katılmadan önce kompakt JSON olarak serileştirilir. Örneğin, platformUserIds, ["1188041528"] olarak işaretler ve k=v yükünde platformUserIds=["1188041528"] verir. Dizi öğesi sırasını, çift tırnakları ve dize kimliklerini koruyun; biçimlendirme boşlukları eklemeyin veya Java List.toString() ([1188041528] gibi) kullanmayın. SDK bu serileştirmeyi otomatik olarak gerçekleştirir.

Normal iş kodu imzaları hesaplamamalı veya manuel olarak ayarlanmamalıdır agentCode, timestamp, nonce veya sign.

Kaynak ve ilgili kılavuzlar