Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class AddressSuggest {
    private static final String API_URL = System.getenv().getOrDefault(
        "DATASARAS_API_URL", "https://api.datasaras.com");
    private static final String API_KEY = System.getenv("DATASARAS_API_KEY");

    public static String suggest(String keyword, int limit) throws Exception {
        String url = API_URL + "/address-api-v1/au/address/suggest"
            + "?keyword=" + java.net.URLEncoder.encode(keyword, "UTF-8")
            + "&limit=" + limit;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("x-auth-key", API_KEY)
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() != 200) {
            throw new RuntimeException("API error: " + response.statusCode());
        }
        return response.body();
    }

    public static void main(String[] args) throws Exception {
        String json = suggest("55 kay st", 10);
        System.out.println(json);
    }
}

// Spring RestTemplate or WebClient
String apiUrl = "https://api.datasaras.com";
String apiKey = env.getProperty("datasaras.api-key");

RestTemplate rest = new RestTemplate();
HttpHeaders headers = new HttpHeaders();
headers.set("x-auth-key", apiKey);

String url = apiUrl + "/address-api-v1/au/address/suggest"
    + "?keyword=" + URLEncoder.encode("55 kay st", StandardCharsets.UTF_8)
    + "&limit=10";

ResponseEntity<String> response = rest.exchange(
    url,
    HttpMethod.GET,
    new HttpEntity<>(headers),
    String.class
);
String json = response.getBody();

datasaras.api-url=https://api.datasaras.com
datasaras.api-key=your_api_key