초 거래 통합
초 거래 통합: Agent Java SDK v0.3.0 통합, 예시, 매개변수 및 응답 의미 체계.
이 가이드는 Agent Java SDK v0.3.0 및 Java 8+를 대상으로 합니다.
본인 확인, 인증, 자금 준비
초 거래는 무기한 거래와 동일한 사용자 바인딩 및 입력 인증을 사용합니다. 자금 잔액을 사용합니다. 영구 마진은 계약 잔액을 사용합니다. 프론트엔드 상품/모드와 백엔드 펀드 환경을 별도로 구성하세요.
다음을 사용하여 client를 초기화합니다. 빠른 시작. 바인딩된 사용자 매핑을 저장하고 인증된 백엔드 세션에서 파트너 사용자 ID를 얻습니다.
항목 리디렉션
SDK는 POST /v1/agent/create-entry-url을 호출합니다. webUrl을 파트너 프런트엔드로 반환하고 즉시 엽니다. expireAt는 Unix 초를 사용합니다. 티켓은 수명이 짧고 일회성입니다. 만료 또는 소비 후에 다른 것을 얻습니다.
6MM에서 제공하는 실제 프런트엔드 경로를 사용하세요. redirectPath는 /로 시작하는 상대 플랫폼 경로입니다. returnUrl는 절대 파트너 HTTP/HTTPS URL 입니다. 입장 티켓은 사용자를 인증하며 전송을 실행하지 않습니다.
삽입된 항목
기존 partner-token 및 tokenProvider 흐름을 사용합니다. 예측별 토큰은 없습니다. 원하는 page 및 tradingMode로 위젯을 생성하고 파트너 백엔드를 호출할 때 현재 channelId를 사용합니다.
SDK는 POST /v1/agent/create-embed-token을 호출합니다. symbol는 선택 사항입니다. 초매매 상품을 선택하지 않습니다. 제품 선택은 프런트엔드에 속합니다. 토큰은 자금 환경을 선택하거나 잔액을 변경하지 않습니다.
완전한 프론트엔드 예시
이러한 옵션은 2026년 10월 10일 공개 Trading Widget 1.8.0 런타임에 대해 확인되었습니다. 위젯과 Agent Java SDK 버전은 독립적입니다.
파트너 백엔드 응답
/api/seconds/embed-token는 새로운 6MM API가 아닌 파트너 소유 엔드포인트입니다. 세션을 인증하고, 서버 측에서 agentUserId를 파생시키고 createEmbedToken를 호출합니다. 다음 최상위 구조를 반환합니다.
예시 값이 아닌 에이전트 응답의 실제 expireAt를 사용하세요. 에이전트 응답에 channelId가 포함되어 있지 않습니다. 백엔드는 현재 요청의 값을 반영합니다. API가 결과를 data로 래핑한 경우 tokenProvider에서 반환하기 전에 해당 레이어의 래핑을 해제하세요. 잘못된 성공 개체를 반환하는 대신 비즈니스 실패를 거부합니다.
모든 초기화 또는 갱신은 새로운 토큰을 얻습니다. 동일한 토큰을 다시 캐시하고 교환하거나 URL 에 넣지 마십시오. 갱신 중에 동일한 인스턴스 채널을 재사용합니다. 인스턴스를 다시 만든 후 새 채널을 사용하세요.
자금 환경에 맞게
demo 프런트엔드에는 environment=SIMULATED를 사용한 시뮬레이션 자금 요청이 필요합니다. real 프런트엔드에는 제작 자금이 필요합니다. tradingMode이나 토큰 생성 모두 백엔드 자금 목표를 변경하지 않습니다.
사용자 전환이나 거래 모드 전환 시 기존 위젯을 삭제하고 새 인스턴스를 생성하세요. 사용자를 자금이 지원된 것으로 처리하기 전에 자금 잔액을 쿼리하고 자금을 이체하고 자금 관련 상태 엔드포인트를 통해 최종 결과를 확인하세요.