Pular para o conteúdo principal

SDK Java

O que você irá aprender com esse artigo?
  • O que é o SDK Java oficial da Merx e quando usá-lo.
  • Como adicionar a dependência ao seu projeto (Maven ou Gradle).
  • Requisitos e autenticação.

O SDK Java oficial (tech.merx.sdk) é uma biblioteca que encapsula as APIs de integração da Merx em métodos idiomáticos Java — sem você precisar montar requisições HTTP, tratar retry ou desserializar JSON na mão.

Cobre os mesmos domínios documentados nesta seção de APIs: cadastros (produtores, fazendas, carteiras), negociações, rastreabilidade e relatórios (CBIOS, EUDR, socioambiental).

Requisitos​

  • Java 11+ (compatível com JVM 11, 17 e 21).
  • Maven 3.6+ ou Gradle.
  • Token de integração — veja Criação de Token.

Instalação​

O SDK é distribuído pelo Maven Central — nenhum repositório extra precisa ser configurado.

Maven​

<dependency>
    <groupId>tech.merx.sdk</groupId>
    <artifactId>sdk-api</artifactId>
    <version>1.1.0</version>
</dependency>

Gradle​

implementation("tech.merx.sdk:sdk-api:1.1.0")

Referência da API (Javadoc)​

A referência completa de classes, métodos e DTOs fica no Javadoc, publicado automaticamente a partir do Maven Central:

https://javadoc.io/doc/tech.merx.sdk/sdk-api

Autenticação​

Você só precisa do token de integração. O SDK envia o header Authorization automaticamente; o cooperative-id é injetado pela camada de gateway da Merx a partir do token — você não precisa enviá-lo.

Um token corresponde a uma cooperativa. Para operar múltiplas cooperativas, instancie um MerxClient por token.

O token é de longa duração (emitido pelo suporte) e o SDK não faz refresh automático. Se o token for rotacionado/revogado, basta atualizar o apiKey ao construir o MerxClient.

Ambientes​

AmbienteEnumBase URL
SandboxEnvironment.SANDBOXhttps://homolog.api.merx.tech
ProduçãoEnvironment.PRODUCTIONhttps://api.merx.tech

Pronto para começar? Siga para o Quickstart.