telize Télécharger - telize Téléchargement du code source

telize

Code source C#

3.1.1

Télécharger

                           t  e  l  i  z  e
                       _______________________
                 ______                     /_______
                \     \           ___     //      /
           __     ____     __    /      _____/ / ____
       ___/  ____/  _//____/  ______/_____   /__/  _//____
      \__    ____  __/  __     __      ____    ____  __/  __///
        /      _   |/    _     /       /     /_/   |/    _
      \   ___/___       /____/_______/   ___/___       /
  <0(--- __/ -h7- ______/          .    __/ ---- ______/ --(0>
                             .     /.      .
                              .   //      /
                         ______\ //______/
                                  Y

Description

Telize est une API REST intégrée à Go permettant d'obtenir l'adresse IP d'un visiteur et d'interroger des informations de localisation à partir de n'importe quelle adresse IP. Il génère des données de géolocalisation IP codées en JSON et prend en charge à la fois JSON et JSONP.

Les opérations de géolocalisation sont effectuées à l'aide du MaxMind DB Reader for Go qui met en cache la base de données dans la RAM. Par conséquent, Telize a des frais généraux très minimes et devrait être extrêmement rapide.

Exigences

Telize nécessite les bibliothèques Go suivantes :

chi : routeur léger, idiomatique et composable - https://github.com/go-chi/chi
maxminddb-golang : lecteur MaxMind DB pour Go - https://github.com/oschwald/maxminddb-golang

Bases de données GeoIP2

Telize nécessite les bases de données gratuites GeoLite2 de MaxMind.

Telize recherchera par défaut les bases de données GeoLite2 City et GeoLite2 ASN dans /var/db/GeoIP .

Installation

Construisez et installez avec l'outil go , toutes les dépendances seront automatiquement récupérées et compilées :

 go build
go install telize

Usage

Par défaut, Telize se liera sur localhost, port 8080.

 USAGE:
  -host string
    	Set the server host (default "127.0.0.1")
  -port string
    	Set the server port (default "8080")
  -version
    	Display version

Exécuter Telize au démarrage

Fichier d'unité Systemd

Telize est fourni avec un fichier d'unité systemd, voir : systemd/telize.service

Copiez le fichier systemd/telize.service dans /etc/systemd/system et le binaire Telize dans /usr/local/sbin .

Pour lancer le démon au démarrage, exécutez :

 systemctl enable telize

Faire des requêtes

Pour une documentation complète sur l'API et des exemples d'utilisation, veuillez consulter le site du projet.

Telize prend en charge les rappels JSONP.

Obtenir l'adresse IP au format texte brut

Exemple : http://127.0.0.1:8080/ip

Obtenir l'adresse IP au format JSON

Exemple (JSON) : http://127.0.0.1:8080/jsonip
Exemple (JSONP) : http://127.0.0.1:8080/jsonip?callback=getip

Obtenir l'emplacement de l'adresse IP au format JSON

L'appel du point de terminaison de l'API sans aucun paramètre renverra l'adresse IP du visiteur :

Exemple (JSON) : http://127.0.0.1:8080/location
Exemple (JSONP) : http://127.0.0.1:8080/location?callback=getlocation

L'ajout d'une adresse IP en tant que paramètre renverra des informations de localisation pour l'adresse donnée :

Exemple (JSON) : http://127.0.0.1:8080/location/46.19.37.108
Exemple (JSONP) : http://127.0.0.1:8080/location/46.19.37.108?callback=getlocation

Erreurs client

Lorsqu'une entrée utilisateur incorrecte est saisie, le serveur renvoie une erreur HTTP 400 (requête incorrecte), ainsi qu'un message d'erreur codé en JSON.

Code 401 : la chaîne d'entrée n'est pas une adresse IP valide

Telize et procurations

Telize gère l'en-tête HTTP 'X-Forwarded-For' s'il est présent et renvoie les données pour la première adresse IP de la liste.

Prise en charge CORS (partage de ressources d'origine croisée)

Telize a activé CORS par défaut avec la stratégie suivante :

 Access-Control-Allow-Origin: *

Décalages de fuseau horaire

Depuis la version 3.0.0, Telize calcule désormais dynamiquement les décalages horaires (décalage horaire UTC) et ajoute des données à la charge utile.