Ir para a navegação
Agent Java SDK

Agent Java SDK

Agent Java SDK: Agent Java SDK integração v0.3.0, exemplos, parâmetros e semântica de resposta.

Ver como Markdown

Este guia é dirigido a Agent Java SDK v0.3.0, Java 8+ e ao contrato público assinalado. Os exemplos são executados num back-end de parceiro após a inicialização de client em Início rápido.

Linha de base da documentação: SDK v0.3.0, commit 54aa3c1. As regras de recepção de Webhook seguem adicionalmente WEBHOOKS.md em fa6c7b6; trata-se de uma atualização apenas de documentação, sem um novo artefacto SDK contendo métodos auxiliares de aviso.

Versão e instalação

ArtigoValor
Etiqueta de origem estávelv0.3.0
JavaJava 8+
MavenMaven 3.9+
Coordenadascom.sixmm.exchange.sdk:agent:0.3.0

Fonte de hosts GitHub; isso não torna estas coordenadas solucionáveis ​​no Maven Central. Utilize a instalação local marcada ou o seu repositório de artefactos aprovado.

O que o SDK cobre

CategoriaCenárioSDK APIDescrição
Vinculação de utilizadorVincular utilizadorbindCriar ou pesquisar a ligação entre um utilizador parceiro e um utilizador da plataforma 6MM
Consultas de ativosConsultar conta do parceiroqueryAccountConsultar a margem do parceiro ou conta de financiamento
Consultas de ativosConsultar ativos do utilizadorqueryUserAssetsConsulta de ativos do Contrato; utilize withFunding() para incluir os saldos de financiamento
TransferênciasTransferência de montante fixotransferTransferir fundos para ou de 6MM
TransferênciasTransfira tudotransferAllOutMova todo o saldo sacável do utilizador de volta para a plataforma do parceiro
TransferênciasOrdem inversareverseReverter uma transferência bem-sucedida quando o back-end suporta um fluxo de compensação
TransferênciasOrdem de consultaqueryOrderConsultar uma ordem de transferência por número de ordem do parceiro
TransferênciasListar pedidoslistOrdersPercorrer ordens de transferência para reconciliação
WebhookVerificação de assinaturaWebhookVerifier.verifyVerificar eventos de fundos brutos e órgãos de alerta de liquidação; o código do comerciante lida com verificações de tempo, propriedade e desduplicação persistente. Ver Webhook Eventos e avisos de liquidação.
Carteira de financiamentoTransferência de financiamentowalletTransferParceiro ↔ Financiamento ou Financiamento ↔ Contrato; confirme o estado retornado
Carteira de financiamentoEstado da transferência de financiamentoqueryWalletTransferRecuperar uma operação de financiamento utilizando o número original do pedido do parceiro
Entrada de negociaçãoEntrada direta URLcreateEntryUrlCrie um SSO URL único para o modo de redireccionamento
Entrada de negociaçãoIncorporar tokencreateEmbedTokenCrie um token de curta duração para o modo Trading Widget tokenProvider
Dados perpétuosPedidos perpétuos atuaislistCurrentPerpetualOrdersConsultar os pedidos atuais de NORMAL ou CONDITIONAL
Dados perpétuosHistórico de encomendas perpétuaslistPerpetualOrderHistoryTerminal de consulta NORMAL ou CONDITIONAL pedidos
Dados perpétuosNegociações perpétuaslistPerpetualTradesConsultar os preenchimentos comerciais para uma lista pública explícita de jogadores
Dados perpétuosPosições perpétuas atuaislistCurrentPerpetualPositionsConsultar posições atuais
Dados perpétuosHistórico de posição perpétualistPerpetualPositionHistoryConsultar posições fechadas
Dados perpétuosRazão de conta perpétualistPerpetualLedgerConsultar registos individuais de alteração de saldo de contrato
Taxas de referência FiatListar moedas fiduciárias suportadaslistSupportedFiatCurrenciesListar moedas fiduciárias atualmente convertíveis em USDT
Taxas de referência FiatConsultar taxas de referência de câmbioqueryExchangeRatesConsultar as taxas de referência diárias entre a moeda fiduciária e USDT para todas as moedas ou moedas selecionadas
Informações de serviçoVersão do serviçoversionConsultar informações da versão do serviço do agente

Configuração

Obtenha os seguintes valores de 6MM antes integrando.

ArtigoExemploDescrição
baseUrlhttps://agent-api.6mm.comAgente API base URL, sem barra final
agentCodeAGENT001Código de parceiro
apiSecretyour-api-secretAPI segredo de assinatura. Mantenha-o apenas no back-end
defaultCurrencyUSDTMoeda padrão, geralmente USDT
webhookUrlhttps://partner.example.com/6mm/webhookCallback do comerciante URL partilhado por todos os quatro tipos de evento; envio por corpo event, sem aviso separado URL.

Recomendações de produção:

  • Utilize HTTPS para os endpoints do agente API e webhook.
  • Armazene apiSecret num gestor secreto, centro de configuração ou variável de ambiente.
  • Mantenha a hora do servidor sincronizada, de preferência com NTP.
  • Mantenha todos os números de encomenda de parceiros e mantenha-os globalmente exclusivos.
  • Nunca envie apiSecret para browsers, aplicações, miniprogramas ou código-fonte front-end.

Campos de assinatura automática

Para chamadas assinadas do Agente API, o SDK injeta automaticamente:

CampoFonteDescrição
agentCodeAgentClientConfig.agentCodeCódigo de parceiro
timestampCarimbo de data/hora Unix atual UTCSegundos
nonceGerador aleatório seguroProteção de repetição
signHMAC-SHA256Solicitar assinatura
currencydefaultCurrencyPreenchido quando os pedidos de transferência/conta omitem moeda

Regras de assinatura:

  1. Apagar sign.
  2. Apague valores vazios.
  3. Ordene as chaves por ordem ASCII.
  4. Registe-se como k=v&k2=v2.
  5. Calcule HMAC-SHA256 hexadecimal com apiSecret.

Os valores da matriz são serializados como compactos JSON antes de se juntarem à carga útil de assinatura. Por exemplo, platformUserIds assina como ["1188041528"], fornecendo platformUserIds=["1188041528"] na carga útil k=v. Preservar a ordem dos elementos do array, as aspas duplas e os IDs de string; não introduza espaços de formatação nem utilize Java List.toString() (como [1188041528]). O SDK trata esta serialização automaticamente.

O código comercial normal não deve calcular as assinaturas nem definir manualmente agentCode, timestamp, nonce, ou sign.

Fonte e guias relacionados