التكامل التجاري للثواني

يستهدف هذا الدليل Agent Java SDK v0.3.0 وJava 8+.

إعداد الهوية والتوثيق والأموال

يستخدم تداول الثواني نفس ربط المستخدم ومصادقة الدخول مثل التداول الدائم. ويستخدم أرصدة التمويل. يستخدم الهامش الدائم أرصدة العقد. قم بتكوين منتج/وضع الواجهة الأمامية وبيئة أموال الواجهة الخلفية بشكل منفصل.

تهيئة client باستخدام بداية سريعة. احفظ تعيين المستخدم المنضم واحصل على معرف المستخدم الشريك من جلسة الواجهة الخلفية التي تمت مصادقتها.

إعادة توجيه الإدخال

import com.sixmm.agent.model.CreateEntryUrlRequest;
import com.sixmm.agent.model.CreateEntryUrlResponse;
CreateEntryUrlResponse entry = client.createEntryUrl(
        CreateEntryUrlRequest.of("merchant-user-001")
                .withRedirectPath("/zh-CN/up-down?tradingMode=demo")
                .withReturnUrl("https://merchant.example/markets"));
String webUrl = entry.webUrl;

يستدعي SDK POST /v1/agent/create-entry-url. قم بإرجاع webUrl إلى الواجهة الأمامية للشريك وافتحها على الفور. expireAt يستخدم ثواني يونكس. التذكرة قصيرة الأجل ولمرة واحدة؛ الحصول على آخر بعد انتهاء الصلاحية أو الاستهلاك.

استخدم مسارات الواجهة الأمامية الفعلية التي يوفرها 6MM. redirectPath هو مسار منصة نسبي يبدأ بـ /؛ returnUrl شريك مطلق HTTP/HTTPS URL. تقوم تذكرة الدخول بتوثيق المستخدم ولا تنفذ عملية نقل.

دخول مضمن

استخدم التدفق الحالي partner-token وtokenProvider. لا يوجد رمز مميز للتنبؤ. قم بإنشاء الأداة باستخدام page وtradingMode، واستخدم channelId الحالية عند استدعاء الواجهة الخلفية للشريك.

import com.sixmm.agent.model.CreateEmbedTokenRequest;
import com.sixmm.agent.model.CreateEmbedTokenResponse;
String channelId = "tw_example_channel";
CreateEmbedTokenResponse auth = client.createEmbedToken(
        CreateEmbedTokenRequest.of("merchant-user-001", channelId));
String embedToken = auth.embedToken;
long expireAt = auth.expireAt;

يستدعي SDK POST /v1/agent/create-embed-token. symbol اختياري؛ ولا يختار منتجًا للتداول بالثواني. اختيار المنتج ينتمي إلى الواجهة الأمامية. لا يحدد الرمز المميز بيئة الأموال أو يغير الأرصدة.

مثال الواجهة الأمامية كاملة

تم التحقق من هذه الخيارات مقابل وقت التشغيل العام Trading Widget 1.8.0 في 10-10-2026. إصدارات القطعة وAgent Java SDK مستقلة.

<div id="seconds-widget" style="width: 100%; height: 720px"></div>
<script src="https://app.6mm.com/sdk/trading-widget/v1/index.js"></script>
<script>
  const page = 'up-down';
  const tradingMode = 'demo';
  const capabilities = TradingWidget.capabilities;
  if (!capabilities?.partnerToken ||
      !capabilities.pages?.includes(page) ||
      !capabilities.tradingModes?.includes(tradingMode)) {
    throw new Error('Trading Widget SDK does not support the requested page or mode');
  }
  const widget = TradingWidget.create('#seconds-widget', {
    baseUrl: 'https://app.6mm.com',
    page,
    tradingMode,
    theme: 'dark',
    locale: 'zh-CN',
    auth: {
      mode: 'partner-token',
      tokenProvider: async ({ channelId }) => {
        // Partner-owned endpoint; derive the user from the backend session.
        const response = await fetch('/api/seconds/embed-token', {
          method: 'POST',
          credentials: 'same-origin',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ channelId }),
        });
        if (!response.ok) {
          throw new Error('Failed to request embed token');
        }
        const result = await response.json();
        if (typeof result.embedToken !== 'string' || !result.embedToken.trim() ||
            !Number.isFinite(result.expireAt) || result.channelId !== channelId) {
          throw new Error('Invalid embed token response');
        }
        return {
          embedToken: result.embedToken,
          expireAt: result.expireAt,
          channelId: result.channelId,
        };
      },
    },
    onReady() {
      console.log('Trading widget ready');
    },
    onError(error) {
      console.error('Trading widget error', error.code);
    },
  });
  window.addEventListener('beforeunload', () => widget.destroy());
</script>

استجابة الواجهة الخلفية للشريك

/api/seconds/embed-token هي نقطة نهاية مملوكة للشريك، وليست 6MM API. قم بتوثيق الجلسة، واستنتج agentUserId من جانب الخادم واتصل بـ createEmbedToken. قم بإرجاع بنية المستوى الأعلى هذه:

{
  "embedToken": "short-one-time-token",
  "expireAt": 1791590700,
  "channelId": "tw_xxx"
}

استخدم expireAt الفعلية لاستجابة الوكيل، وليس القيمة التوضيحية. لا تحتوي استجابة الوكيل على channelId؛ الواجهة الخلفية الخاصة بك تعكس قيمة الطلب الحالي. إذا كانت التفافات API تؤدي إلى data، فقم بفك تلك الطبقة قبل العودة من tokenProvider. رفض فشل الأعمال بدلاً من إرجاع كائن نجاح غير صالح.

تحصل كل تهيئة أو تجديد على رمز مميز جديد. لا تقم أبدًا بتخزين نفس الرمز المميز مرة أخرى أو استبداله مرة أخرى، أو وضعه في URL. إعادة استخدام نفس قناة المثيل أثناء التجديد؛ استخدم القناة الجديدة بعد إعادة إنشاء المثيل.

تطابق بيئة الأموال

تتطلب الواجهة الأمامية demo محاكاة طلبات الأموال باستخدام environment=SIMULATED. تتطلب الواجهة الأمامية real أموال الإنتاج. لا tradingMode ولا إنشاء الرمز المميز يغير هدف الأموال الخلفية.

عند تبديل المستخدمين أو وضع التداول، قم بتدمير القطعة القديمة وإنشاء مثيل جديد. الاستعلام عن أرصدة التمويل، وتحويل الأموال وتأكيد النتيجة النهائية من خلال نقطة نهاية الحالة الخاصة بالتمويل قبل معاملة المستخدم على أنه ممول.

يرى محفظة التمويل و دليل البيئة.

المصدر والأدلة ذات الصلة

• المصدر الرسمي v0.3.0
• نظرة عامة على الاستعلام وترقيم الصفحات
• محفظة التمويل
• دليل الترقية