IP API Documentation

1. Add Dependencies

dependencies {
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.google.code.gson:gson:2.11.0'
}

2. Create API Manager

import com.google.gson.Gson;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

public class ApiManager {
    private static final String BASE_URL = "https://findipinfo.net/api/ipinfo/%s";
    private final OkHttpClient client;
    private final Gson gson;

    public ApiManager() {
        client = new OkHttpClient();
        gson = new Gson();
    }

    public void fetchGeolocationData(String apiKey, String ipAddress, GeolocationCallback callback) {
        String url = String.format(BASE_URL, apiKey) + (ipAddress != null ? "?ip=" + ipAddress : "");
        Request request = new Request.Builder().url(url).build();

        client.newCall(request).enqueue(new okhttp3.Callback() {
            @Override
            public void onFailure(okhttp3.Call call, IOException e) {
                callback.onFailure(e.getMessage());
            }

            @Override
            public void onResponse(okhttp3.Call call, Response response) throws IOException {
                if (!response.isSuccessful()) {
                    callback.onFailure("Request failed: " + response.code());
                    return;
                }
                String json = response.body().string();
                GeolocationData data = gson.fromJson(json, GeolocationData.class);
                callback.onSuccess(data);
            }
        });
    }
}

3. Define Callback Interface

public interface GeolocationCallback {
    void onSuccess(GeolocationData data);
    void onFailure(String error);
}

4. Create Data Model

public class GeolocationData {
    private boolean success;
    private String message;
    private FindIpInfo data;

    // Getters and setters
    public boolean isSuccess() { return success; }
    public void setSuccess(boolean success) { this.success = success; }
    public String getMessage() { return message; }
    public void setMessage(String message) { this.message = message; }
    public FindIpInfo getData() { return data; }
    public void setData(FindIpInfo data) { this.data = data; }

    public static class FindIpInfo {
        private String continent;
        private String country;
        private String city;
        private String capital;
        private String country_code;
        private String country_alpha_3_code;
        private String region;
        private String postal;
        private double latitude;
        private double longitude;
        private String network;
        private String timeZone;
        private String organization;
        private int system_number;
        private String telephone_code;
        private String currency_code;
        private String currency_name;
        private String currency_symbol;
        private String lang_code;
        private String lang_name;
        private String country_domain_name;
        private String flag_w40;
        private String flag_w80;
        private String flag_w160;
        private String flag_w320;
        private String flag_w640;
        private String flag_svg;

        // Getters and setters (omitted for brevity, add as needed)
    }
}

ApiManager apiManager = new ApiManager();
apiManager.fetchGeolocationData("your-api-key-here", "123.45.67.89", new GeolocationCallback() {
    @Override
    public void onSuccess(GeolocationData data) {
        runOnUiThread(() -> {
            if (data.isSuccess()) {
                dataTextView.setText("Country: " + data.getData().getFindipinfo().getCountry());
            } else {
                dataTextView.setText(data.getMessage() + " (Code: " + (data.getErrorCode() != null ? data.getErrorCode() : "N/A") + ")");
            }
        });
    }

    @Override
    public void onFailure(String error) {
        runOnUiThread(() -> dataTextView.setText("Error: " + error));
    }
});