Gratis geografisk placering af besøgende på webstedet med ipstack API (gennemgang)

Siden dens ydmyge begyndelse for over 25 år siden,world wide web har udviklet sig på måder, som selv de bedste analytikere aldrig kunne have forudsagt. Form det, der i det væsentlige var et værktøj til at hjælpe forskere med at dele information, det har udviklet sig til et forbrugerværktøj, som mange af os simpelt ikke kan leve uden. Det har ændret mange aspekter af vores liv, og vi er kommet til at stole på det, måske mere end vi burde. Det er blevet så almindeligt, at det ændrer detailbranchen. Fra store kæder af mursten og mørtelbutikker er de bedste forhandlere nu webbaserede markedspladser.

For at få succes har onlineforhandlere ikke kun brug forfor at være til stede på nettet, men de er også nødt til at udnytte dens funktioner fuldt ud. En sådan funktion er geolocation. Denne teknologi kan give en forhandler mulighed for at kende placeringen af ​​besøget på sit websted, en nyttig funktion til at give dem mulighed for at få vist anslåede forsendelsesomkostninger eller præsentere lokaliseringsspecifikke tilbud. En af de nemmeste måder at drage fordel af geolocation er at bruge en dedikeret API, der kan fodres med en IP-adresse, og som vil returnere alle relevante oplysninger om den adresse. Det ipstack API er et sådant produkt, og vi er ved at opdagehvordan det gør sin magi, og hvad det kan gøre for dig. Vi ser på værktøjets grundlæggende funktionalitet og hvordan det bruges. Vi ser, hvordan det fungerer, hvilken type dokumentation og support, der er tilgængelig for produktet, og se på dets ganske enkle prisstruktur.

Introduktion til ipstack

I kernen er ipstack en geolocation API, sombruger flere sammenkoblede internetudbydere til at levere nøjagtige geografiske data. Du kalder API'en fra dit websteds kode, og det vil returnere en overflod af geografiske data om dit websteds brugere. Du får naturligvis brugerens geografiske placering (er det ikke det vigtigste punkt?), Men det er ikke alt. F.eks. Returnerer værktøjet et link til et billede af brugerens landsflag eller en emoji-version af det. Desuden får du information om, hvorvidt brugeren får adgang til dit websted via en proxy. Vi går nærmere ind på alt dette, da vi ser nærmere på de tilgængelige moduler.

Projektet, oprindeligt kaldet freegeoip.net, så lyset tilbage i 2009 som et open source-initiativ til at hjælpe udviklere. Gennem kontinuerlig forbedring baseret på brugerfeedback udviklede det sig otte år senere til det fulde produkt, som vi ser på. I løbet af denne tid voksede produktets brugerbase op til over hundrede tusinde tilfredse kunder. Og de er ikke bare nogen kunder. Giganter som Microsoft eller Samsung bruger API. Det samme er Airbnb og HubSpot.

Ipstack API bruger et meget dynamisk skemader opdaterer sin database flere gange om dagen, hvilket sikrer integriteten af ​​de returnerede resultater. Til dette formål har ipstack samarbejdet med flere store internetudbydere over hele verden. Værktøjet udfører al kommunikation over 256-bit SSL-krypteret kanal - ved hjælp af HTTPS - for at sikre alle dataoverførsler. Resultater kan returneres af API'en i enten XML- eller JSON-format, afhængigt af dine specifikke behov.

En af de bedste dele af ipstack API er densmodularitet. Forskellige tilgængelige moduler returnerer stadig flere data om brugerens placering. Det giver et meget fleksibelt værktøj. Hastighed er også en af ​​produktets forte. Du kalder API'en med de relevante parametre og får de ønskede resultater superhurtigt. I øjeblikket håndterer ipstack API mere end to milliarder anmodninger dagligt, og det svarer stadig næsten med det samme. Gennem et partnerskab med forskellige internetudbydere kan produktet dække omkring 2 millioner lokationer og over 200.000 byer over hele verden. Det understøtter også IPv4- og IPv6-adresser.

Sådan fungerer geolocation

Før vi går videre, lad os kort pause ogkig hurtigt på, hvordan geolocation ser ud. Som du gætte fra ipstacks navn, har det at gøre med IP-adresser. IP-adresser kan sammenlignes - til en vis grad - med postadresser. Hver internet-tilsluttet enhed har en unik IP-adresse. Men disse IP-adresser tildeles ikke kun tilfældigt til enhver enhed. Der er en vis mening i det. En del af en IP-adresse identificerer den individuelle tilsluttede enhed, og en del af den identificerer det netværk, det er forbundet til. Og selve netværksdelen er hierarkisk organiseret, ligesom et computerdisk katalogtræ. (Jeg håber, at ingeniørerne blandt vores læsere vil tilgive mig for denne overforenkling.)

Dette ligner en postadresse med en gadenummer, et gadenavn, en by og til sidst et land. Og ligesom det britiske post ikke har nogen idé om, hvor en hvilken som helst amerikansk adresse er placeret, sender den amerikansk-bundet post til USPS, som vil sørge for at dirigere posten til det rigtige sted. Og ligesom du kunne indtaste stort set enhver postadresse i et værktøj som Google map og få den nøjagtigt tilsvarende placering, kan du spørge om et værktøj som ipstack API med en IP-adresse for at få dets placering.

Dette har dog nogle begrænsninger. For eksempel får du ikke den nøjagtige placering fra IP-adressen. Hvad du får, er hvad ISP, der leverer IP-adressen, kan give. Dette er ofte ikke meget mere præcist end byen eller det almindelige kvarter, selvom nogle udbydere returnerer mere information end andre. Hvis brugeren også sagsøger en VPN for at få adgang til dit websted, er det, du får fra en sådan opslag, placeringen af ​​VPN-serveren, de bruger.

Vigtigste funktioner i ipstack API

Udviklerne af ipstack API valgte at bruge enmodulær tilgang til dette produkt. Det består af forskellige moduler, der hver returnerer en anden type information. Der er for eksempel moduler af tidszone, valuta eller endda sikkerhed. Du vælger hvilket modul der skal bruges ved hjælp af de relevante parametre, når du sender anmodningen til ipstack API.

Der er et par fordele ved denne tilgang. For det første gør det responsen lettere at håndtere. Hvis der kun var en type anmodning, der returnerede alle tilgængelige data om en IP-adresse, ville dit websteds kode skulle analysere hele svaret for at hente de oplysninger, det har brug for. Afsendelse af mindre anmodninger - med mindre svar - kan også forbedre ydelsen.

Lad os se et dybere kig på hver af de tilgængeligemodul, hvordan man ringer til dem, og hvordan deres typiske respons ser ud. Det giver dig et ret klart overblik over, hvad du kan forvente af dette magtfulde værktøj.

Placeringsmodulet

Ipstack API's mest basale modul erPlaceringsmodul. Det returnerer detaljer om den fysiske placering af den IP-adresse, der er angivet i forespørgslen. Du får landets IP-adresse, dets hoved- eller officielle sprog samt en emoji til landets flag, som du kan bruge til at tilpasse din brugeroplevelse.

Her er et typisk svar på en forespørgsel til ipstack API. Den første del er inkluderet i enhver forespørgsel, uanset det ønskede modul:

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

De fleste af de returnerede attributter er selvforklarende, men du har detaljeret dokumentation på ipstacks websted, hvis du har brug for yderligere hjælp.

Men da vi taler om placeringsmodulet, så lad os se på, hvilke ekstra oplysninger der returneres, når vi bruger det:

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: false

Som du kan se, er de ekstra oplysninger, du fårhovedsageligt landets hovedstad, de forskellige sprog, der bruges på det sted, et link til et billede af landets flag og unicode for landets emoji.

Valutamodulet

Valutamodulet kan bruges til at videreføreforbedre dit websted brugeroplevelse. Dette gælder især for et shoppingwebsted, da det giver dig mulighed for at vise priser i din brugers valuta. Detaljerne inkluderer det lokale valutas navn og symbol såvel som dets plural navn. API'en konverterer naturligvis ikke priser til den rette valuta, men det giver dig mulighed for at bruge en anden API til at konvertere dine priser til den rigtige valuta for dine besøgende. Lad os se på, hvordan output fra valutamodulet ser ud:

currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"

Sikkerhedsmodulet

Sandsynligvis ikke så populær - eller nyttig - som den foregåendemoduler, er sikkerhedsmodulet stadig interessant. Det returnerer oplysninger om flere sikkerhedsaspekter ved den indgående forbindelse. For eksempel vil det fortælle dig, om der er adgang til webstedet via en proxy, og i bekræftende fald typen af ​​proxy, eller om anmodningen kom ind via tor-netværket. Det kan også fortælle dig, at en anmodning kommer fra en gennemsøgning snarere end en faktisk bruger. Denne type information kan bruges til at forhindre skrabning. Modulet returnerer også det trusselsniveau, der er knyttet til den leverede IP-adresse, hvilket muligvis muliggør råbeskyttelse mod ondsindede anmodninger. Her er et kig på det typiske svar fra sikkerhedsmodulet:

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: null

Tidszone-modulet

Et andet modul, som kan komme godt medpersonliggør dine besøgendes brugeroplevelse er modulet Time Zone. Det giver nogle ekstra detaljer om - du gættede det - dine besøgende på webstedet. Et af de steder, hvor du kunne bruge en sådan funktion på websteder, der beskæftiger sig med tidssensitiv information. Det giver dig mulighed for at vise det korrekte tidspunkt baseret på dine brugers placering.

Modulet indeholder information som GMT-forskydning, aktuel brugertid, tidskode og tidszone-placering, som du kan se fra dette eksempelsvar:

time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: true

Forbindelsesmodulet

Sidst men ikke mindst er forbindelsesmodulet. Denne er temmelig forenklet. Alt det returnerer er det autonome systemnummer (AS) -nummer, der er knyttet til kildens IP-adresse samt ISP-navnet. Det er faktisk navnet på AS-ejeren snarere ISP. Nogle organisationer registrerer deres eget autonome system, som det er tilfældet i eksemplet herunder:

connection: Object{}
asn: 395399
isp: "City of Montreal"

Dette er sandsynligvis det mindst nyttige af alle modulerne, men nogle vil finde det nyttigt til forskellige analytiske formål.

Arbejde med ipstack API

Vi har set på, hvad information kan værereturneret af ipstack API, er det nu tid til at se på, hvordan det kaldes. Ipstack API tilbyder tre forskellige typer forespørgsler hver med forskellige parametre. Der er standardopslag, bulksøgning og anmodning om anmodning. Lad os se, hvordan de adskiller sig. Dette er en dejlig funktion, da masseforespørgslen for eksempel tillader en at kombinere flere anmodninger i en, hvilket reducerer det samlede omkostning og giver mulighed for hurtigere resultater. Lad os se et dybere kig på hver type anmodning.

Standard opslag

Som du måske har gætt, er Standard Lookupden mest basale. Det returnerer detaljerne om en enkelt IP-adresse, som du giver, når du ringer til ipstack API. Det er temmelig enkelt at bruge, og det fungerer med enten IPv4- eller IPv6-adresser. For at gøre tingene endnu lettere giver produktets dokumentation prøvekode til standardanmodningen i både PHP (cURL) og JavaScript (Jquery.ajax). Hvis dit websted er bygget ved hjælp af en af ​​disse, er API virkelig en no-brainer. Her er et eksempel på et typisk opkald til API ved hjælp af simpel HTML-kode:

https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY

I dette eksempel YOUR_ACCESS_KEY ville blive erstattet af den faktiske adgangsnøgle dufik, da du tilmeldte dig tjenesten. Du vil også medtage den faktiske IP-adresse, du vil have oplysninger om snarere end den dummy, i dette eksempel.

Resultaterne for en standardopslag inkluderer allemoduler som standard, men ekstra parametre giver dig mulighed for at indstille anmodningen til dine nøjagtige behov. Alle detaljer om de tilgængelige parametre er klart forklaret i produktdokumentationen. Ligeledes er standardsvaret et JSON-objekt, men parametre kan ændre det til et XML-format.

Bulk- og anmodningsopslag

Bulk-opslag giver dig mulighed for at anmode om data imodflere IP-adresser inden for en enkelt anmodning. Ligesom standardopslag kan du få data på både IPv4- og IPv6-adresser. Du kan endda blande begge typer adresser i en enkelt anmodning. Formatet for anmodningen er det samme som i standardopslag bortset fra at du specificerer flere IP-adresser adskilt af kommaer.

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

Den sidste type forespørgsel, som ipstack tilbyderAPI er Requester Lookup. Det returnerer oplysninger om den IP-adresse, hvor anmodningen kommer fra. Det er den type anmodning, du vil køre fra med et script på klientsiden. For at foretage et opkaldsopkaldsopkald er det eneste, du gør, at bruge nøgleordet “check” i stedet for en IP-adresse. De andre tilgængelige anmodningsparametre er de samme som for andre anmodningstyper.

https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY

Hvordan fungerer ipstack API'en?

Ipstack API er mere end sandsynligt nogetdu vil integreres i et websted i realtid. For eksempel vil du måske servere forskellige indhold baseret på klientens placering. For at opnå det har du brug for API'en for at udføre flammende hurtigt. Enhver forsinkelse i API-svaret vil oversætte til forsinkelser, der viser siden til din klient, noget du mere end sandsynligt ønsker at undgå. Det samme er tilfældet, uanset hvad du bruger placeringsdataene til. Dette er grunden til, at responstiden for det værktøj, du bruger, er meget vigtig. Mens en geolocation API kan give en meget tiltrængt funktionalitet, kan dens manglende udførelse have en katastrofal indvirkning.

Af disse grunde skal du vælge en API medgod responstid. Vi har gjort meget af det hårde arbejde med at teste forskellige scenarier og kørt test med enkelt eller flere IP-adresser, nogle med flere valgfri parametre, nogle med mindre. Vi var meget tilfredse med resultaterne og fik en ret konsistent responstid på omkring 100 ms, uanset anmodningen. Responsen var også konsistent over tid uden nogen tilsyneladende "rush hours", når ydeevnen ville lide, og det var også ens, uanset hvor vi lancerede anmodningerne fra. Det ser ud til, at ipstack-serverne er bygget til at håndtere den belastning, de får. Generelt ser det ud til, at brug af ipstack API næppe havde nogen indflydelse på webstedets respons set fra en brugers perspektiv.

Produktdokumentation og support

Det siges ofte, at et produkt kun er så godtsom dens dokumentation. Hvis det er sandt, har ipstack API intet at frygte, da dens dokumentation er let at finde, bruge og forstå. Kvaliteten af ​​dokumentationen giver også et mål for, hvor meget en softwareudgiver interesserer sig for sine brugere. Her igen er der intet at bekymre sig om.

En af de bedste ting ved dette produktdokumentation er, mærkeligt nok, hvor lidt der er. Alt passer på en enkelt, velindrettet webside, hvor du nemt kan finde alt, hvad du har brug for. Og for at gøre tingene endnu nemmere gør en menulinje adgang til ethvert givet afsnit en leg. Dokumentationen dækker alt fra brug af de forskellige typer forespørgsler til tilpasning af svaret.

I det meget usandsynlige tilfælde, når du ikke ville gøre detfind det, du har brug for i dokumentationen, support er også tilgængelig. Det kan tage lidt tid at først nå teknisk support, men når du først gør det, reagerer de ret hurtigt.

Prisfastsættelse

Flere prisplaner er tilgængelige foripstack API. På det laveste niveau er der den gratis plan. Som navnet antyder, er denne gratis. Det er også noget begrænset. For det første kan du kun køre op til 10 000 forespørgsler pr. Måned. Det inkluderer også placeringsmodulet, og adgangen til support er begrænset. Det kan dog være en god måde at teste produktet og se, hvordan det kan integreres i dit miljø.

Det næste niveau er den grundlæggende plan. Denne sælger for $ 9,99 / måned eller $ 95,90 / år (en 20% rabat) og bringer anmodningsgrænsen op til 50 000 / måned. Det giver dig også mulighed for at bruge valuta-, tidszone- og forbindelsesmodulerne. Derudover er forbedret support også inkluderet i planen samt forbedret sikkerhed ved hjælp af SSL-kryptering.

Den mest populære plan er den professionelleder sælger for $ 49.99 / måned eller $ 479,90 / år. Det giver dig alt, hvad der er inkluderet i basisplanen, men hæver den månedlige anmodningsgrænse til 500 000 og inkluderer også muligheden for at udføre bulkanmodninger.

Øverst er den professionelle plusplan. Det koster $ 99,99 / måned eller $ 959,90 / år. Det er identisk med den professionelle plan, men det tillader op til 2 millioner anmodninger om måneden, og det er den eneste plan, der inkluderer sikkerhedsmodulet.

Hvis det ikke er nok, er der også entilpasset virksomhedsplan, der kan arrangeres ved at kontakte ipstack. Det kan indeholde så mange månedlige anmodninger, som du muligvis har brug for, samt forskellige tilpassede løsninger baseret på en klients specifikke behov.

Afslutningsvis

Ipstack API er et fremragende produkt, der villader dig hente så meget af de data, du kan få fra en IP-adresse hurtigt og nemt. Det har en fantastisk responstid, fremragende dokumentation og god support, der kombinerer for at gøre dette til en god værdi for pengene. Selve det faktum, at flere internetgiganter bruger det, er sandsynligvis et godt vidnesbyrd om produktets værdi.

Dette er bestemt et produkt, jeg vil anbefale, hvisdu ser på at udnytte de data, der kan indsamles til din besøgendes IP-adresse. Og da der er en gratis - om end begrænset - plan tilgængelig, er der ingen grund til, at du i det mindste ikke skal prøve at prøve dig selv, hvad den kan gøre for dig.