탐색으로 건너뛰기
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK v0.3.0 통합, 예시, 매개변수 및 응답 의미 체계.

Markdown으로 보기

이 가이드는 Agent Java SDK v0.3.0, Java 8+ 및 태그된 공개 계약을 대상으로 합니다. 예제는 client를 초기화한 후 파트너 백엔드에서 실행됩니다. 빠른 시작.

문서 기준: SDK v0.3.0, 커밋 54aa3c1. Webhook 수신 규칙도 추가로 따릅니다. WEBHOOKS.md fa6c7b6에서; 이는 경고 도우미 메서드가 포함된 새로운 SDK 아티팩트가 없는 문서 전용 업데이트입니다.

버전 및 설치

목값
안정적인 소스 태그v0.3.0
JavaJava 8+
메이븐메이븐 3.9+
좌표com.sixmm.exchange.sdk:agent:0.3.0

GitHub 호스트 소스; Maven Central에서 이러한 좌표를 확인할 수는 없습니다. 태그가 지정된 로컬 설치 또는 승인된 아티팩트 저장소를 사용하십시오.

SDK의 내용

범주대본SDK API설명
사용자 바인딩사용자 바인딩bind파트너 사용자와 6MM 플랫폼 사용자 간의 바인딩을 생성하거나 가져옵니다.
자산 쿼리파트너 계정 조회queryAccount파트너 마진 또는 자금 조달 계정 쿼리
자산 쿼리사용자 자산 쿼리queryUserAssets계약 자산 쿼리 자금 잔액을 포함하려면 withFunding()을 사용하세요.
환승정액이체transfer6MM 안팎으로 자금을 이체하세요.
환승모두 전송transferAllOut출금 가능한 모든 사용자 잔액을 파트너 플랫폼으로 다시 이동
환승역순reverse백엔드가 보상 흐름을 지원하는 경우 성공적인 전송을 되돌립니다.
환승쿼리 순서queryOrder파트너 주문 번호로 하나의 이전 주문을 쿼리합니다.
환승주문 나열listOrders조정을 위한 이전 주문 페이지
Webhook서명 확인WebhookVerifier.verify원시 자금 이벤트 및 청산 경고 기관을 확인합니다. 판매자 코드는 시간, 소유권 및 지속적인 중복 제거 확인을 처리합니다. 보다 Webhook 이벤트 및 청산 경고.
펀딩 지갑자금 이체walletTransfer파트너 ⇔ 펀딩 또는 펀딩 ⇔ 계약 반환된 상태를 확인하세요
펀딩 지갑자금 이체 상태queryWalletTransfer원래 파트너 주문 번호를 사용하여 자금 조달 작업을 복구합니다.
거래 진입직접 입력 URLcreateEntryUrl리디렉션 모드에 대한 일회성 SSO URL 만들기
거래 진입토큰 내장createEmbedTokenTrading Widget tokenProvider 모드에 대한 단기 토큰 생성
영구 데이터현재 무기한 주문listCurrentPerpetualOrders현재 NORMAL 또는 CONDITIONAL 주문 쿼리
영구 데이터무기한주문 내역listPerpetualOrderHistory쿼리 터미널 NORMAL 또는 CONDITIONAL 주문
영구 데이터무기한 거래listPerpetualTrades명시적인 공개 플레이어 목록에 대한 거래 채우기 쿼리
영구 데이터현재 영구 포지션listCurrentPerpetualPositions현재 위치 쿼리
영구 데이터영구 포지션 내역listPerpetualPositionHistory마감된 포지션 쿼리
영구 데이터영구 계정 원장listPerpetualLedger개별 계약 잔액 변경 기록 조회
법정화폐 참조 환율지원되는 법정화폐 나열listSupportedFiatCurrencies현재 USDT로 전환할 수 있는 법정화폐 목록을 나열하세요.
법정화폐 참조 환율FX 기준금리 조회queryExchangeRates전체 또는 선택한 통화에 대한 일일 법정화폐 대 USDT 기준 비율을 쿼리합니다.
서비스 안내서비스 버전version쿼리 에이전트 서비스 버전 정보

구성

이전에 6MM에서 다음 값을 얻습니다. 통합.

목예설명
baseUrlhttps://agent-api.6mm.com에이전트 API 기본 URL, 후행 슬래시 없음
agentCodeAGENT001파트너 코드
apiSecretyour-api-secretAPI 서명 비밀입니다. 백엔드에만 유지
defaultCurrencyUSDT기본 통화, 일반적으로 USDT
webhookUrlhttps://partner.example.com/6mm/webhook판매자 콜백 URL 네 가지 이벤트 유형 모두에서 공유됩니다. 본체로 발송 event, 별도의 경고 없이 URL.

생산 권장사항:

  • 에이전트 API 및 webhook 엔드포인트에는 HTTPS를 사용합니다.
  • 비밀 관리자, 구성 센터 또는 환경 변수에 apiSecret를 저장합니다.
  • 가급적이면 NTP을 사용하여 서버 시간을 동기화하세요.
  • 모든 파트너 주문 번호를 유지하고 전 세계적으로 고유하게 유지하세요.
  • 브라우저, 앱, 미니 프로그램 또는 프런트엔드 소스 코드에 apiSecret을 보내지 마세요.

자동 서명 필드

서명된 에이전트 API 호출의 경우 SDK는 자동으로 다음을 삽입합니다.

필드원천설명
agentCodeAgentClientConfig.agentCode파트너 코드
timestamp현재 UTC Unix 타임스탬프초
nonce보안 난수 생성기재생 보호
signHMAC-SHA256서명 요청
currencydefaultCurrency이체/계좌 요청 시 작성 통화 생략

서명 규칙:

  1. sign을 제외합니다.
  2. 빈 값을 제외합니다.
  3. ASCII 순서로 키를 정렬합니다.
  4. k=v&k2=v2로 가입하세요.
  5. HMAC-SHA256 16진수를 apiSecret로 계산합니다.

배열 값은 서명 페이로드에 합류하기 전에 압축된 JSON로 직렬화됩니다. 예를 들어, platformUserIds는 ["1188041528"]로 서명되어 k=v 페이로드에 platformUserIds=["1188041528"]를 제공합니다. 배열 요소 순서, 큰따옴표 및 문자열 ID를 유지합니다. 서식 지정 공백을 삽입하거나 Java List.toString()(예: [1188041528])를 사용하지 마세요. SDK는 이 직렬화를 자동으로 처리합니다.

일반 비즈니스 코드는 서명을 계산하거나 수동으로 설정해서는 안 됩니다. agentCode, timestamp, nonce 또는 sign.

소스 및 관련 가이드