t e l i z e
_______________________
______\ /_______
\\ \\ ___ // /
__ \ ____ \ __ / \ _____/\ / ____
___/ \____/ _//____/ \___\___/___\__ /__/ _//____
\\__ ____ __/ __ __ ____ ____ __/ __///
/ \_ |/ \_ / \/ /_/ |/ \_
\\\ ___/\___ /____/\_______/\ ___/\___ /
<0(--- \__/ -h7- \______/ \ . \__/ ---- \______/ --(0>
\ .\ /. .
\ .\ // /
\______\\ //______/
Y
Telize is a REST API built in C with Kore allowing to get a visitor IP address and to query location information from any IP address. It outputs JSON-encoded IP geolocation data, and supports both JSON and JSONP.
Geolocation operations are performed using libmaxminddb which caches the database in RAM. Therefore, Telize has very minimal overhead and should be blazing fast.
Telize requires Kore 3.2.0+ and libmaxminddb.
Telize requires the free GeoLite2 databases from MaxMind.
mkdir -p /var/db/GeoIP
cd /var/db/GeoIP
wget https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz
wget https://geolite.maxmind.com/download/geoip/database/GeoLite2-ASN.tar.gz
tar xfz GeoLite2-City.tar.gz
tar xfz GeoLite2-ASN.tar.gz
mv */*mmdb .
Using the kodev tool:
kodev build
Using the kodev tool:
kodev run
The default Telize configuration does not have logging enabled, it must be configured manually.
If your Telize instance produces lots of logs, Logswan might be of interest.
Telize has CORS enabled by default with the following policy:
Access-Control-Allow-Origin: *
For complete API documentation and usage examples, please check the project site.
- Example: http://127.0.0.1/ip
- Example (JSON): http://127.0.0.1/jsonip
- Example (JSONP): http://127.0.0.1/jsonip?callback=getip
Calling the API endpoint without any parameter will return the visitor IP address:
- Example (JSON): http://127.0.0.1/location
- Example (JSONP): http://127.0.0.1/location?callback=getgeoip
Appending an IP address as parameter will return location information for the given address:
- Example (JSON): http://127.0.0.1/location/46.19.37.108
- Example (JSONP): http://127.0.0.1/location/46.19.37.108?callback=getgeoip
Telize is released under the BSD 2-Clause license. See LICENSE file
for details.
Telize is developed by Frederic Cambus.
- Site: https://www.cambus.net
Project homepage: https://www.telize.com
Latest tarball release: https://www.statdns.com/telize/telize-2.0.0.tar.gz