Depuis ses humbles débuts il y a plus de 25 ans,Le World Wide Web a évolué d'une manière que même les meilleurs analystes n'auraient jamais pu prévoir. Formant ce qui était essentiellement un outil pour aider les chercheurs à partager des informations, il est devenu un outil de consommation dont beaucoup d’entre nous ne peuvent tout simplement pas se passer. Il a changé de nombreux aspects de nos vies et nous en sommes venus à en dépendre, peut-être plus que nous le devrions. Il est devenu si courant qu'il change l'industrie du commerce de détail. Des grandes chaînes de magasins de brique et de mortier, les meilleurs détaillants sont désormais des marchés en ligne.
Pour réussir, les détaillants en ligne doivent non seulementpour être présent sur le Web, mais ils doivent également utiliser pleinement ses fonctionnalités. L'une de ces caractéristiques est la géolocalisation. Cette technologie peut permettre à un détaillant de connaître l'emplacement du visiteur de son site Web, une fonctionnalité utile pour lui permettre d'afficher les frais d'expédition estimés ou de présenter des offres spécifiques à l'emplacement. L'une des façons les plus simples de bénéficier de la géolocalisation est d'utiliser une API dédiée qui peut être alimentée avec une adresse IP et qui renverra toutes les informations pertinentes sur cette adresse. le API ipstack est un de ces produits et nous allons découvrircomment il fait sa magie et ce qu'il peut faire pour vous. Nous allons voir les fonctionnalités de base de l'outil ainsi que la façon de l'utiliser. Nous verrons comment il fonctionne, quel type de documentation et d'assistance est disponible pour le produit et examinons sa structure de prix plutôt simple.
Présentation d'ipstack
À la base, ipstack est une API de géolocalisation quiutilise plusieurs FAI interconnectés pour fournir des données géographiques précises. Vous appelez l'API à partir du code de votre site Web et elle renverra une pléthore de données géographiques sur les utilisateurs de votre site Web. Vous obtiendrez bien sûr la position géographique de l'utilisateur (n'est-ce pas là le point principal?) Mais ce n'est pas tout. Par exemple, l'outil renvoie un lien vers une image du drapeau du pays de l'utilisateur ou une version emoji de celui-ci. En outre, vous obtiendrez des informations indiquant si l'utilisateur accède à votre site via un proxy. Nous allons approfondir tout cela en examinant plus en détail les modules disponibles.
Le projet, initialement appelé freegeoip.net, a vu le jour en 2009 comme une initiative open source pour aider les développeurs. Grâce à une amélioration continue basée sur les commentaires des utilisateurs, il a évolué environ huit ans plus tard pour devenir le produit à part entière que nous examinons. Pendant cette période, la base d'utilisateurs du produit a atteint plus de cent mille clients satisfaits. Et ce ne sont pas seulement des clients. Des géants comme Microsoft ou Samsung utilisent l'API. Il en va de même pour Airbnb et HubSpot.
L'API ipstack utilise un schéma hautement dynamiquequi met à jour sa base de données plusieurs fois par jour, garantissant l'intégrité des résultats renvoyés. À cette fin, ipstack s'est associé à plusieurs grands FAI à travers le monde. L'outil effectue toutes les communications sur un canal crypté SSL 256 bits - en utilisant HTTPS - pour sécuriser tous les transferts de données. Les résultats peuvent être renvoyés par l'API au format XML ou JSON, selon vos besoins spécifiques.
L'une des meilleures parties de l'API ipstack est sonmodularité. Les différents modules disponibles renvoient de plus en plus de données sur l'emplacement de l'utilisateur. Cela en fait un outil très flexible. La vitesse est également l'un des points forts du produit. Vous appelez l'API avec le ou les paramètres appropriés et obtenez les résultats demandés très rapidement. Actuellement, l'API ipstack gère plus de deux milliards de demandes par jour et répond toujours presque instantanément. Grâce à un partenariat avec divers FAI, le produit peut couvrir quelque 2 millions de sites et plus de deux cent mille villes dans le monde. Il prend également en charge les adresses IPv4 et IPv6.
Fonctionnement de la géolocalisation
Avant d'aller plus loin, arrêtons-nous brièvement etjetez un coup d'œil à la géolocalisation. Comme vous le devinez d'après le nom d'ipstack, cela a à voir avec les adresses IP. Les adresses IP peuvent être comparées - dans une certaine mesure - aux adresses postales. Chaque appareil connecté à Internet possède une adresse IP unique. Mais ces adresses IP ne sont pas simplement attribuées au hasard à chaque appareil. Cela a un certain sens. Une partie d'une adresse IP identifie le périphérique connecté individuel et une partie identifie le réseau auquel il est connecté. Et la partie réseau elle-même est organisée hiérarchiquement, un peu comme une arborescence de répertoires de disques informatiques. (J'espère que les ingénieurs parmi nos lecteurs me pardonneront cette simplification excessive.)
Cela ressemble à une adresse postale avec une rueun numéro, un nom de rue, une ville et, éventuellement, un pays. Et tout comme la poste britannique n'a aucune idée de l'endroit où se trouve une adresse aux États-Unis, elle enverra du courrier à destination des États-Unis à l'USPS qui se chargera d'acheminer le courrier au bon endroit. Et tout comme vous pouvez entrer à peu près n'importe quelle adresse postale dans un outil tel que Google map et obtenir l'emplacement correspondant exact, vous pouvez interroger un outil tel que l'API ipstack avec une adresse IP pour obtenir son emplacement.
Cela a cependant quelques limites. Par exemple, vous n'obtiendrez pas l'emplacement exact de l'adresse IP. Vous obtiendrez tout ce que le FAI fournissant l’adresse IP pourra vous fournir. Ce n'est souvent pas beaucoup plus précis que la ville ou le quartier général, bien que certains fournisseurs retournent plus d'informations que d'autres. De plus, si l'utilisateur poursuit un VPN pour accéder à votre site Web, ce que vous obtiendriez d'une telle recherche est l'emplacement du serveur VPN qu'il utilise.
Caractéristiques principales de l'API ipstack
Les développeurs de l'API ipstack ont choisi d'utiliser unapproche modulaire avec ce produit. Il se compose de différents modules, chacun renvoyant un type d'informations différent. Il existe, par exemple, des modules de fuseau horaire, de devise ou même de sécurité. Vous choisissez le module à utiliser en utilisant les paramètres appropriés lors de l'envoi de la demande à l'API ipstack.
Cette approche présente quelques avantages. Tout d'abord, cela rend la réponse plus facile à gérer. S'il n'y avait qu'un seul type de demande renvoyant toutes les données disponibles sur une adresse IP, le code de votre site Web devrait analyser l'intégralité de la réponse pour récupérer les informations dont il a besoin. En outre, l'envoi de demandes plus petites, avec des réponses plus petites, peut améliorer les performances.
Examinons de plus près chacune des options disponiblesmodule, comment les appeler et à quoi ressemble leur réponse typique. Cela vous donnera un aperçu assez clair de ce à quoi s'attendre de cet outil puissant.
Le module de localisation
Le module le plus basique de l'API ipstack est leModule de localisation. Il renvoie des détails sur l'emplacement physique de l'adresse IP fournie dans la requête. Vous obtiendrez le pays de l'adresse IP, sa langue principale ou officielle ainsi qu'un emoji pour le drapeau du pays que vous pourrez utiliser pour personnaliser l'expérience de votre utilisateur.
Voici une réponse typique à une requête adressée à l'API ipstack. La première partie est incluse avec toute requête, quel que soit le module demandé:
ip: "142.243.254.224" hostname: "142.243.254.224" type: "ipv4" continent_code: "NA" continent_name: "North America" country_code: "CA" country_name: "Canada" region_code: "QC" region_name: "Quebec" city: "Montreal" zip: H2V latitude: 45.5178 longitude: -73.6046
La plupart des attributs retournés sont explicites, mais vous avez une documentation détaillée sur le site Web d'ipstack si vous avez besoin d'aide supplémentaire.
Mais puisque nous parlons du module de localisation, regardons quelles informations supplémentaires sont retournées lors de son utilisation:
location: Object {}
geoname_id: null
capital: "Ottawa"
languages: Object {}
code: "en"
name: "English"
native: ""English""
code: "fr"
name: "French"
native: ""Français""
country_flag: "http://assets.ipstack.com/flags/ca.svg"
country_flag_emoji: "??"
country_flag_emoji_unicode: "U+1F1E8 U+1F1E6"
calling_code: "1"
is_eu: falseComme vous pouvez le voir, les informations supplémentaires que vous obtenez sontprincipalement la capitale du pays, les différentes langues utilisées à cet endroit, un lien vers une image du drapeau du pays et l'unicode des emoji du pays.
Le module de devise
Le module Devise peut être utilisé pouraméliorez l'expérience utilisateur de votre site Web. Cela est particulièrement vrai pour un site de magasinage car il vous permettra d'afficher les prix dans la devise de votre utilisateur. Les détails fournis incluent le nom et le symbole de la devise locale ainsi que son nom pluriel. L'API ne convertira pas les prix dans la bonne devise, bien sûr, mais elle vous permettra d'utiliser une autre API pour convertir vos prix dans la bonne devise pour vos visiteurs. Voyons à quoi ressemble la sortie du module de devise:
currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"Le module de sécurité
Probablement pas aussi populaire ou utile que le précédentmodules, le module de sécurité est toujours intéressant. Il renvoie des informations sur plusieurs aspects de sécurité de la connexion entrante. Par exemple, il vous indiquera si le site est accessible via un proxy et, dans l'affirmative, le type de proxy ou si la demande a été envoyée via le réseau tor. Il peut également vous indiquer qu'une demande provient d'un robot plutôt que d'un utilisateur réel. Ce type d'informations peut être utilisé pour éviter le grattage. Le module renvoie également le niveau de menace associé à l'adresse IP fournie, ce qui permet potentiellement une protection brute contre les demandes malveillantes. Voici un aperçu de la réponse typique du module de sécurité:
security: Object{}
is_proxy: false
proxy_type: null
is_crawler: false
crawler_name: null
crawler_type: null
is_tor: false
threat_level: "low"
threat_types: nullLe module de fuseau horaire
Un autre module qui peut être utile pourpersonnaliser l'expérience utilisateur des visiteurs de votre site Web est le module Fuseau horaire. Il renvoie quelques détails supplémentaires sur - vous l'avez deviné - les visiteurs de votre site Web. L'un des endroits où vous pourriez utiliser une telle fonctionnalité dans les sites qui traitent des informations sensibles au facteur temps. Il vous permet d'afficher l'heure correcte en fonction de l'emplacement de vos utilisateurs.
Le module fournit des informations telles que le décalage GMT, l'heure actuelle de l'utilisateur, le code temporel et l'emplacement du fuseau horaire, comme vous pouvez le voir dans cet exemple de réponse:
time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: trueLe module de connexion
Le dernier mais non le moindre est le module de connexion. Celui-ci est plutôt simpliste. Il ne renvoie que le numéro du système autonome (AS) associé à l'adresse IP source ainsi que le nom du FAI. Eh bien, c'est en fait le nom du propriétaire de l'AS plutôt que du FAI. Certaines organisations enregistrent leur propre système autonome, comme c'est le cas dans l'exemple ci-dessous:
connection: Object{}
asn: 395399
isp: "City of Montreal"C'est probablement le moins utile de tous les modules, mais certains le trouveront utile à diverses fins analytiques.
Travailler avec l'API ipstack
Nous avons regardé quelles informations peuvent êtreretourné par l'API ipstack, il est maintenant temps de voir comment il est appelé. L'API ipstack propose trois types de requêtes différents avec chacun des paramètres différents. Il existe la recherche standard, la recherche en bloc et la recherche de demandeur. Voyons comment ils diffèrent. Il s'agit d'une fonctionnalité intéressante car, par exemple, la demande groupée permet de combiner plusieurs demandes en une seule, réduisant ainsi les frais généraux totaux et permettant des résultats plus rapides. Examinons de plus près chaque type de demande.
Recherche standard
Comme vous l'avez peut-être deviné, la recherche standard estle plus élémentaire. Il renvoie les détails d'une seule adresse IP que vous fournissez lors de l'appel de l'API ipstack. Il est assez simple à utiliser et fonctionnera avec les adresses IPv4 ou IPv6. Pour rendre les choses encore plus faciles, la documentation du produit fournit un exemple de code pour la demande standard en PHP (cURL) et JavaScript (Jquery.ajax). Si votre site Web est construit à l'aide de l'un de ces éléments, l'utilisation de l'API est vraiment une évidence. Voici un exemple d'un appel typique à l'API utilisant du code HTML simple:
https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY
Dans cet exemple, YOUR_ACCESS_KEY serait remplacé par la clé d'accès réelle que vousobtenu lorsque vous vous êtes inscrit au service. Vous devez également inclure l'adresse IP réelle sur laquelle vous souhaitez obtenir des informations plutôt que l'adresse fictive dans cet exemple.
Les résultats d'une recherche standard incluent tous lesmodules par défaut mais des paramètres supplémentaires vous permettent d'adapter la demande à vos besoins exacts. Tous les détails sur les paramètres disponibles sont clairement expliqués dans la documentation du produit. De même, la réponse par défaut est un objet JSON mais les paramètres peuvent le changer en un format XML.
Recherches en vrac et par demandeur
La recherche groupée vous permet de demander des données surplusieurs adresses IP dans une seule demande. Tout comme la recherche standard, vous pouvez obtenir des données sur les adresses IPv4 et IPv6. Vous pouvez même mélanger les deux types d'adresses dans une seule demande. Le format de la demande est le même que celui de la recherche standard, sauf que vous spécifiez plusieurs adresses IP séparées par des virgules.
https://api.ipstack.com/123.123.123.123,124.124.124.124,125.125.125.125, 126.126.126.126?access_key=YOUR_ACCESS_KEY
Le dernier type de demande proposé par l'ipstackL'API est la recherche de demandeur. Il renverra des informations sur l'adresse IP d'où provient la demande. Il s'agit du type de demande que vous exécutez à partir d'un script côté client. Pour effectuer un appel de recherche de demandeur, il vous suffit d'utiliser le mot-clé «vérifier» au lieu d'une adresse IP. Les autres paramètres de demande disponibles sont les mêmes que pour les autres types de demande.
https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY
Comment fonctionne l'API ipstack?
L'API ipstack est, plus que probablement, quelque chosevous souhaitez intégrer dans un site Web en temps réel. Par exemple, vous souhaiterez peut-être diffuser un contenu différent en fonction de l'emplacement du client. Pour ce faire, vous avez besoin de l'API pour être extrêmement rapide. Tout retard dans la réponse de l'API se traduira par des retards d'affichage de la page à votre client, ce que vous voudriez probablement éviter. La même chose est vraie, peu importe la raison pour laquelle vous utilisez les données de localisation. C’est pourquoi le temps de réponse de l’outil que vous utilisez est de la plus haute importance. Alors qu'une API de géolocalisation peut fournir une fonctionnalité indispensable, son incapacité à effectuer peut avoir un impact désastreux.
Pour ces raisons, vous devez choisir une API avecbon temps de réponse. Nous avons effectué une grande partie du travail acharné de test de divers scénarios et exécuté des tests avec une ou plusieurs adresses IP, certains avec des paramètres plus facultatifs, certains avec moins. Nous avons été très satisfaits des résultats et avons obtenu un temps de réponse assez constant d'environ 100 ms, quelle que soit la demande. La réponse a également été constante dans le temps, sans «heures de pointe» apparentes lorsque les performances en souffriraient et elle était également similaire, peu importe d'où nous avons lancé les demandes. Il semble que les serveurs ipstack soient conçus pour gérer la charge qu'ils reçoivent. Dans l'ensemble, il semble que l'utilisation de l'API ipstack n'ait eu pratiquement aucun effet sur la réponse du site Web du point de vue de l'utilisateur.
Documentation et assistance produit
On dit souvent qu'un produit est aussi boncomme sa documentation. Si cela est vrai, l'API ipstack n'a rien à craindre car sa documentation est facile à trouver, à utiliser et à comprendre. La qualité de la documentation donne également une mesure de combien un éditeur de logiciels se soucie de ses utilisateurs. Là encore, il n'y a rien à craindre.
L'une des meilleures choses à propos de ce produitla documentation est, curieusement, le peu qu'il y a. Tout tient sur une seule page Web bien conçue où vous trouverez facilement tout ce dont vous avez besoin. Et pour rendre les choses encore plus faciles, un volet de menu facilite l'accès à une section donnée. La documentation couvre tout, de l'utilisation des différents types de demandes à la personnalisation de la réponse.
Dans le cas très improbable où vous ne seriez pastrouver ce dont vous avez besoin dans la documentation, une assistance est également disponible. Cela peut prendre un certain temps pour atteindre initialement le support technique mais, une fois que vous le faites, ils répondent assez rapidement.
Prix
Plusieurs plans tarifaires sont disponibles pour leAPI ipstack. Au niveau le plus bas, il y a le plan gratuit. Comme son nom l'indique, celui-ci est gratuit. Il est également quelque peu limité. Pour commencer, vous ne pouvez exécuter que 10 000 requêtes par mois. Il comprend également uniquement le module de localisation et l'accès au support est limité. Cela peut cependant être un excellent moyen de tester le produit et de voir comment il peut s'intégrer dans votre environnement.
Le niveau suivant est le plan de base. Celui-ci se vend 9,99 $ / mois ou 95,90 $ / an (une remise de 20%) et porte la limite de demandes à 50 000 / mois. Il vous permet également d'utiliser les modules Devise, Fuseau horaire et Connexion. En outre, un support amélioré est également inclus dans le plan ainsi qu'une sécurité renforcée grâce à l'utilisation du cryptage SSL.
Le plan le plus populaire est le plan professionnelqui se vend 49,99 $ / mois ou 479,90 $ / an. Il vous donne tout ce qui est inclus dans le plan de base, mais augmente la limite mensuelle de demandes à 500 000 et inclut également la possibilité de faire des demandes groupées.
Au sommet se trouve le plan professionnel plus. Il en coûte 99,99 $ / mois ou 959,90 $ / an. Il est identique au plan professionnel mais il permet jusqu'à 2 millions de demandes par mois et c'est le seul plan à inclure le module de sécurité.
Si cela ne suffit pas, il y a aussi unplan d'entreprise personnalisable qui peut être organisé en contactant ipstack. Il peut inclure autant de demandes mensuelles que nécessaire, ainsi que diverses solutions personnalisées en fonction des besoins spécifiques du client.
En conclusion
L'API ipstack est un excellent produit quivous permet de saisir rapidement et facilement autant de données que vous pouvez obtenir d'une adresse IP. Il a un temps de réponse incroyable, une excellente documentation et un bon support qui se combinent pour en faire un excellent rapport qualité / prix. De plus, le fait même que plusieurs géants de l'Internet l'utilisent est probablement un bon témoignage de la valeur du produit.
C'est certainement un produit que je recommanderais sivous envisagez d'exploiter les données qui peuvent être collectées pour l'adresse IP du visiteur de votre site Web. Et puisqu'un plan gratuit, quoique limité, est disponible, il n'y a aucune raison pour que vous ne devriez pas au moins essayer, voir par vous-même ce qu'il peut faire pour vous.
commentaires