appaydin/gclib repository overview

⁠IP Geolocation & Exchange Rate API

The service is free. Maxmind-DB is used for geographic location determination. The European Central Bank and the Central Bank of the Republic of Turkey used to exchange rates.

⁠Development

Written using Swoole Http Server. It achieves an average "35k/sec" request on a 4-core machine.

⁠PHP Library

• Swoole⁠
• FastRoute⁠
• Maxmind Reader⁠

⁠Automatic Update

Swool Scheduler is made with continuous update. The update is checked every 24 hours. The database is downloaded 2 times in one month.

⁠Installation

You can run the api with Docker.

version: '3.4'

services:
    gclib:
        image: appaydin/gclib
        ports:
            - 90:9500
        environment:
            - SWOOLE_PORT=9500
            - SWOOLE_WORKER=2
            - DBCITY=https://download.maxmind.com/...

Generate DBCITY URL: https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=LICENSE_KEY&suffix=tar.gz⁠

LICENSE_KEY: You can obtain the license key from your Maxmind account.

⁠Geo Location API

Geo locate client:

GET http://127.0.0.1:90/geolocate

Custom IP adress:

GET http://127.0.0.1:90/geolocate/IP

⁠Exhange Rate API

Latest exchange rates:

GET http://127.0.0.1:90/exrate/ecb/latest #European Central Bank
GET http://127.0.0.1:90/exrate/tcmb/latest #The Central Bank of the Republic of Turkey

Custom exchange rate (only ecb):

GET http://127.0.0.1:90/exrate/ecb/2019-07-18 #European Central Bank

Custom exchange rate range (only ecb):

GET http://127.0.0.1:90/exrate/ecb/2019-07-02/2019-07-05 #European Central Bank

Custom Parameters:

Change Base Currency

GET ?base=USD
GET ?base=EUR

List Specific Currencies

GET ?symbol=USD,TRY,EUR
GET ?base=EUR&symbol=USD,TRY