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 é direcionado a Agent Java SDK v0.3.0, Java 8+ e ao contrato público marcado. Os exemplos são executados em um 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 recebimento de Webhook seguem adicionalmente WEBHOOKS.md em fa6c7b6; esta é uma atualização apenas de documentação, sem um novo artefato SDK contendo métodos auxiliares de aviso.

Versão e instalação

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

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

O que o SDK cobre

CategoriaCenárioSDK APIDescrição
Vinculação de usuárioVincular usuáriobindCrie ou busque a ligação entre um usuário parceiro e um usuário da plataforma 6MM
Consultas de ativosConsultar conta do parceiroqueryAccountConsultar a margem do parceiro ou conta de financiamento
Consultas de ativosConsultar ativos do usuárioqueryUserAssetsConsulta de ativos do Contrato; use withFunding() para incluir saldos de financiamento
TransferênciasTransferência de valor fixotransferTransferir fundos para ou de 6MM
TransferênciasTransfira tudotransferAllOutMova todo o saldo sacável do usuário de volta para a plataforma do parceiro
TransferênciasOrdem inversareverseReverter uma transferência bem-sucedida quando o back-end oferece suporte a 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 status retornado
Carteira de financiamentoStatus da transferência de financiamentoqueryWalletTransferRecuperar uma operação de financiamento usando o número original do pedido do parceiro
Entrada de negociaçãoEntrada direta URLcreateEntryUrlCrie um SSO URL único para o modo de redirecionamento
Entrada de negociaçãoIncorporar tokencreateEmbedTokenCrie um token de curta duração para o modo Trading Widget tokenProvider
Dados perpétuosPedidos perpétuos atuaislistCurrentPerpetualOrdersConsultar pedidos atuais de NORMAL ou CONDITIONAL
Dados perpétuosHistórico de pedidos perpétuoslistPerpetualOrderHistoryTerminal de consulta NORMAL ou CONDITIONAL pedidos
Dados perpétuosNegociações perpétuaslistPerpetualTradesConsultar 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 registros individuais de alteração de saldo de contrato
Taxas de referência FiatListar moedas fiduciárias suportadaslistSupportedFiatCurrenciesListar moedas fiduciárias atualmente conversíveis em USDT
Taxas de referência FiatConsultar taxas de referência de câmbioqueryExchangeRatesConsultar taxas de referência diárias entre 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.

ItemExemploDescriçã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/webhookRetorno de chamada do comerciante URL compartilhado por todos os quatro tipos de evento; envio por corpo event, sem aviso separado URL.

Recomendações de produção:

  • Use HTTPS para endpoints do agente API e webhook.
  • Armazene apiSecret em um gerenciador 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 pedido de parceiros e mantenha-os globalmente exclusivos.
  • Nunca envie apiSecret para navegadores, aplicativos, miniprogramas ou código-fonte de 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 solicitações de transferência/conta omitem moeda

Regras de assinatura:

  1. Excluir sign.
  2. Exclua valores vazios.
  3. Classifique as chaves por ordem ASCII.
  4. Cadastre-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 ingressar na 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, aspas duplas e IDs de string; não insira espaços de formatação nem use Java List.toString() (como [1188041528]). O SDK lida com essa serialização automaticamente.

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

Fonte e guias relacionados