Exemple bàsic d’aplicació que consumeix l’API fent servir el framework Spring (Java).

En aquest cas es realitza un consum del recurs de municipis de l’API https://api.meteo.cat/referencia/v1/municipis. Un cop s’obté una resposta, mostra per la sortida estàndard l’Status code i el seu contingut.

En aquest cas s’ha optat per fer servir la classe RestTemplate per fer la consulta HTTP. Aquesta classe pertany al framework Spring i entre d’altres aspectes ens permet establir un token de seguretat.

// RestTemplate és una classe de Spring que permet fer consultes HTTP
RestTemplate restTemplate = new RestTemplate();
        
// La classe HttpHeaders ens permet establir la capçalera de seguretat i el tipus de retorn
HttpHeaders headers = new HttpHeaders();

String host = "https://api.meteo.cat"; 
String path = "/referencia/v1/municipis";
String apiKey = "xxxxxxx";

String url = host + path;

try {
    // fixem tipus de contingut del body
    headers.setContentType(MediaType.APPLICATION_JSON);

    // afegim capçalera de seguretat: APIKEY
    headers.add("x-api-key", apiKey);

    // creem HttpEntity per poder afegir capçaleres a consulta
    HttpEntity entity = new HttpEntity("parameters", headers);
    
    // fem la consulta amb el Mètode GET de HTTP
    ResponseEntity response = restTemplate.exchange(url, HttpMethod.GET, entity, String.class);
    
    System.out.println("Status: " + response.getStatusCode());
    System.out.println"Contingut: " + response.getBody());

} catch (Exception ex) {
    System.out.println("error executant la consulta", ex);
}

Aquest codi per si sol no és funcional, i s’ha d’integrar en un mètode d’un projecte java.