Documentación de la API

// SincronizarReglas.java — Java 17+, solo biblioteca estándar.
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.nio.file.Files;
import java.nio.file.Path;
import java.time.Duration;

public class SincronizarReglas {
    private static final String BASE = "https://api-security.ipsmart.app";

    public static void main(String[] args) throws Exception {
        String token = System.getenv("API_SECURITY_TOKEN");
        if (token == null || token.isBlank()) {
            throw new IllegalStateException("falta API_SECURITY_TOKEN en el entorno");
        }

        Path ficheroHash = Path.of("reglas.hash");
        String previo = Files.exists(ficheroHash) ? Files.readString(ficheroHash).trim() : "";

        HttpRequest peticion = HttpRequest.newBuilder(URI.create(BASE + "/api/security/rules"))
                .header("Authorization", "Bearer " + token)
                .timeout(Duration.ofSeconds(30))
                .build();

        HttpResponse<String> resp = HttpClient.newHttpClient()
                .send(peticion, BodyHandlers.ofString());

        if (resp.statusCode() == 401) throw new IllegalStateException("token rechazado");
        if (resp.statusCode() == 503) { System.out.println("reglas aun no generadas"); return; }
        if (resp.statusCode() != 200) throw new IllegalStateException("HTTP " + resp.statusCode());

        String actual = resp.headers().firstValue("x-rules-hash").orElse("");
        if (actual.equals(previo)) {
            System.out.println("sin cambios");
            return;
        }

        Files.writeString(Path.of("reglas.md"), resp.body());
        Files.writeString(ficheroHash, actual);
        System.out.println("reglas actualizadas: " + actual);
    }
}