Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings
forked fromipinfo/java

Official Java library for IPinfo API (IP geolocation and other types of IP data)

License

NotificationsYou must be signed in to change notification settings

jabran988/java

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IPinfo IPinfo Java Client Library

License

This is the official Java client library for theIPinfo.io IP address API, allowing you to look up your own IP address, or get any of the following details for an IP:

  • IP geolocation data (city, region, country, postal code, latitude, and longitude)
  • ASN information (ISP or network operator, associated domain name, and type, such as business, hosting, or company)
  • Company data (the name and domain of the business that uses the IP address)
  • Carrier details (the name of the mobile carrier and MNC and MCC for that carrier if the IP is used exclusively for mobile traffic)

Check all the data we have for your IP addresshere.

Getting Started

You'll need an IPinfo API access token, which you can get by signing up for a free account athttps://ipinfo.io/signup.

The free plan is limited to 50,000 requests per month, and doesn't include some of the data fields such as IP type and company data. To enable all the data fields and additional request volumes seehttps://ipinfo.io/pricing

Click here to view the Java SDK's API documentation.

The library also supports the Lite API, see theLite API section for more info.

Installation

Maven

Add these values to your pom.xml file:

Dependency:

<dependencies>    <dependency>        <groupId>io.ipinfo</groupId>        <artifactId>ipinfo-api</artifactId>        <version>3.1.0</version>        <scope>compile</scope>    </dependency></dependencies>

Quick Start

IP Information
importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out the hostnameSystem.out.println(response.getHostname());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}
ASN Information
importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {ASNResponseresponse =ipInfo.lookupASN("AS7922");// Print out country nameSystem.out.println(response.getCountry());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Errors

  • ErrorResponseException: A runtime exception accessible through theExecutionException of a future. This exception signals that something wentwrong when mapping the API response to the wrapper. You probably can'trecover from this exception.
  • RateLimitedException An exception signaling that you've been rate limited.
Lite API

The library gives the possibility to use theLite API too, authentication with your token is still required.

The returned details are slightly different from the Core API.

importio.ipinfo.api.IPinfoLite;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponseLite;publicclassMain {publicstaticvoidmain(String...args) {IPinfoLiteipInfoLite =newIPinfoLite.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseLiteresponse =ipInfoLite.lookupIP("8.8.8.8");// Print out the ASNSystem.out.println(response.getAsn());// AS15169// Print out the country codeSystem.out.println(response.getCountryCode());// US// Print out the country nameSystem.out.println(response.getCountry());// United States        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Caching

This library provides a very simple caching system accessible inSimpleCache.Simple cache is an in-memory caching system that resets every time you restartyour code.

If you prefer a different caching methodology, you may use theCacheinterface and implement your own caching system around your own infrastructure.

The default cache length is 1 day, this can be changed by calling theSimpleCache constructor yourself.

importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {// 5 Day CacheIPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .setCache(newSimpleCache(Duration.ofDays(5)))                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out the hostnameSystem.out.println(response.getHostname());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Country Name Lookup

This library provides a system to lookup country names through ISO2 countrycodes.

importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out the country codeSystem.out.println(response.getCountryCode());// Print out the country nameSystem.out.println(response.getCountryName());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

EU Country Lookup

This library provides a system to lookup if a country is a member of the European Union (EU) throughISO2 country codes.

importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out whether the country is a member of the EUSystem.out.println(response.isEU());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Internationalization

This library provides a system to lookup if a country is a member of the European Union (EU), emoji and unicode of the country's flag, code and symbol of the country's currency, and public link to the country's flag image as an SVG and continent code and name through ISO2 country codes.

importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out whether the country is a member of the EUSystem.out.println(response.isEU());// CountryFlag{emoji='🇺🇸',unicode='U+1F1FA U+1F1F8'}System.out.println(response.getCountryFlag());// https://cdn.ipinfo.io/static/images/countries-flags/US.svgSystem.out.println(response.getCountryFlagURL());// CountryCurrency{code='USD',symbol='$'}System.out.println(response.getCountryCurrency());// Continent{code='NA',name='North America'}System.out.println(response.getContinent());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Location Information

This library provides an easy way to get the latitude and longitude of an IP Address:

importio.ipinfo.api.IPinfo;importio.ipinfo.api.errors.RateLimitedException;importio.ipinfo.api.model.IPResponse;publicclassMain {publicstaticvoidmain(String...args) {IPinfoipInfo =newIPinfo.Builder()                .setToken("YOUR TOKEN")                .build();try {IPResponseresponse =ipInfo.lookupIP("8.8.8.8");// Print out the Latitude and LongitudeSystem.out.println(response.getLatitude());System.out.println(response.getLongitude());        }catch (RateLimitedExceptionex) {// Handle rate limits here.        }    }}

Extra Information

  • This library is thread-safe. Feel free to call the different endpoints fromdifferent threads.
  • This library uses Square's http client. Please refer to their documentationto get information on more functionality you can use.

Other Libraries

There are officialIPinfo client libraries available for many languages including PHP, Python, Go, Java, Ruby, and many popular frameworks such as Django, Rails, and Laravel. There are also many third-party libraries and integrations available for our API.

About IPinfo

Founded in 2013, IPinfo prides itself on being the most reliable, accurate, and in-depth source of IP address data available anywhere. We process terabytes of data to produce our custom IP geolocation, company, carrier, VPN detection, hosted domains, and IP type data sets. Our API handles over 40 billion requests a month for 100,000 businesses and developers.

image

About

Official Java library for IPinfo API (IP geolocation and other types of IP data)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java99.2%
  • Shell0.8%
[8]ページ先頭
©2009-2025 Movatter.jp