Inicio rápido de servidor con Java

Inicio rápido de la API de cartera con Java | ChainsFlow

Solicita una cartera normalizada limitada por la clave API con Java. El ejemplo muestra el flujo de servidor seguro más sencillo.

El token personal permanece en el servidor
Los identificadores de cartera son recursos opacos
Los encabezados de crédito hacen observable el consumo

Ejemplo de servidor copiable

Ejemplo de solicitud

var client = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(5))
    .build();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.chainsflow.com/api/v1/portfolio"))
    .header("X-API-Key", System.getenv("CHAINSFLOW_API_KEY"))
    .timeout(Duration.ofSeconds(10))
    .GET()
    .build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());

Guarda la autenticación fuera del código fuente

Java HttpClient mantiene una superficie de dependencias reducida; encapsúlalo en un adaptador de infraestructura tipado en lugar de llamarlo desde los controladores.

Usa los identificadores devueltos por la API

Crea carteras con POST /api/v1/portfolios y guarda el portfolioId devuelto en tu backend. La clave API define el límite de propiedad.

Gestiona el contrato de respuesta

Comprueba el estado HTTP antes de decodificar los datos correctos. Los errores utilizan application/problem+json; las respuestas correctas con consumo incluyen encabezados con el coste y el saldo de créditos.

Contrato y referencias oficiales

Especificación OpenAPI pública de ChainsFlow ↗