https://github.com/ipfinder-io/ip-finder-java
Official Java client library for IPfinder
https://github.com/ipfinder-io/ip-finder-java
api api-client asn domain firewall ip ipv4 ipv4-address ipv6 ipv6-address nginx
Last synced: 5 months ago
JSON representation
Official Java client library for IPfinder
- Host: GitHub
- URL: https://github.com/ipfinder-io/ip-finder-java
- Owner: ipfinder-io
- License: apache-2.0
- Created: 2019-08-15T22:56:42.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-05-20T21:06:35.000Z (about 4 years ago)
- Last Synced: 2024-11-15T04:09:46.825Z (over 1 year ago)
- Topics: api, api-client, asn, domain, firewall, ip, ipv4, ipv4-address, ipv6, ipv6-address, nginx
- Language: Java
- Homepage: https://ipfinder.io
- Size: 63.5 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# IPFinder Java Client Library
The official Java client library for the [IPFinder.io](https://ipfinder.io) get details for :
- IP address details (city, region, country, postal code, latitude and more ..)
- ASN details (Organization name, registry,domain,comany_type, and more .. )
- Firewall by supported formats details (apache_allow, nginx_deny, CIDR , and more ..)
- IP Address Ranges by the Organization name details (list_asn, list_prefixes , and more ..)
- service status details (queriesPerDay, queriesLeft, key_type, key_info)
- Get Domain IP (asn, organization,country_code ....)
- Get Domain IP history (total_ip, list_ip,organization,asn ....)
- Get list Domain By ASN, Country,Ranges (select_by , total_domain , list_domain ....)
## Getting Started
singup for a free account at [https://ipfinder.io/auth/signup](https://ipfinder.io/auth/signup), for Free IPFinder API access token.
The free plan is limited to 4,000 requests a day, and doesn't include some of the data fields
To enable all the data fields and additional request volumes see [https://ipfinder.io/pricing](https://ipfinder.io/pricing).
## Documentation
See the [official documentation](https://ipfinder.io/docs).
## Installation
Add these values to your pom.xml file:
```xml
io.ipfinder.api
ipfinder-io
1.0.1
```
## With `free` TOKEN
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.IPResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("", ""); // emty token == free
try {
// lookup your IP address information
IPResponse response = ipfinder.authentication();
System.out.println(response.toString());
// print city name
System.out.println(response.getCity());
} catch (IPfinderException e) {
// Handle error
}
}
}
```
## Authentication
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.IPResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
// lookup your IP address information
IPResponse response = ipfinder.authentication();
System.out.println(response.toString());
// print city name
System.out.println(response.getCity());
} catch (IPfinderException e) {
// Handle error
}
}
}
```
## Get IP address
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.IPResponse;
import io.ipfinder.api.exception.IPfinderException;
// lookup IP address information
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
// lookup your IP address information
String ip = "5.2.0.2";
IPResponse response = ipfinder.getAddressInfo(ip);
System.out.println(response.toString());
// print city name
System.out.println(response.getCity());
} catch (IPfinderException e) {
// Handle error
}
}
}
```
## Get ASN
This API available as part of our Pro and enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.AsnResponse;
import io.ipfinder.api.exception.IPfinderException;
// lookup Asn information
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
// lookup Asn information
String asn = "as36947";
AsnResponse response = ipfinder.getAsn(asn);
// print data
System.out.println(response);
// print continent name
System.out.println(response.getContinentName());
} catch (IPfinderException e) {
// Handle error
}
}
}
```
## Firewall
This API available as part of our enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).
formats supported are : `apache_allow`, `apache_deny`,`nginx_allow`,`nginx_deny`, `CIDR`, `linux_iptables`, `netmask`, `inverse_netmask`, `web_config_allow `, `web_config_deny`, `cisco_acl`, `peer_guardian_2`, `network_object`, `cisco_bit_bucket`, `juniper_junos`, `microtik`
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
String asn = "as36947";
String format = "nginx_deny";
String response = ipfinder.getFirewall(asn,format);
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Get IP Address Ranges
This API available as part of our enterprise [https://ipfinder.io/pricing](https://ipfinder.io/pricing).
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.RangeResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
String org = "Telecom Algeria";
RangeResponse response = ipfinder.getRanges(org);
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Get service status
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.StatusResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
StatusResponse response = ipfinder.getStatus();
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Get Domain IP
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.DomainResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
String name = "google.com";
DomainResponse response = ipfinder.getDomain(name);
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Get Domain IP history
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.DomainHtResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
String name = "google.com";
DomainHtResponse response = ipfinder.getDomainHistory(name);
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Get list Domain By ASN, Country,Ranges
```java
import io.ipfinder.api.Ipfinder;
import io.ipfinder.api.data.DomainByResponse;
import io.ipfinder.api.exception.IPfinderException;
public class Main {
public static void main(String... args) {
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "");
try {
String by = "DZ";
DomainByResponse response = ipfinder.getDomainBy(by);
// print data
System.out.println(response);
} catch (IPfinderException ex) {
// Handle error
System.out.println(e);
}
}
}
```
## Add proxy
```java
Ipfinder ipfinder = new Ipfinder("YOUR_TOKEN_GOES_HERE", "https://ipfinder.yourdomain.com");
```
Sample codes under **examples/** folder.
## Contact
Contact Us With Additional Questions About Our API, if you would like more information about our API that isn’t available in our IP geolocation API developer documentation, simply [contact](https://ipfinder.io/contact) us at any time and we’ll be able to help you find what you need.
## License
----
[](https://github.com/ipfinder-io/ip-finder-java)