Od svojich skromných začiatkov pred 25 rokmi,Celosvetový web sa vyvinul spôsobmi, ktoré nemohli predvídať ani tí najlepší analytici. Z formy, ktorá bola v podstate nástrojom na pomoc výskumníkom pri zdieľaní informácií, sa vyvinula v spotrebiteľský nástroj, bez ktorého mnohí z nás jednoducho nemôžu žiť. Zmenilo to mnoho aspektov nášho života a začali sme sa naň spoľahnúť, možno viac, ako by sme mali. Stalo sa tak bežným, že mení maloobchodný priemysel. Z veľkých reťazcov kamenných obchodov sú dnes najpredávanejšími webovými trhmi.
Aby boli maloobchodníci online úspešní, potrebujú nielenbyť prítomný na webe, musia však tiež plne využívať jeho funkcie. Jednou z takýchto funkcií je geolokácia. Táto technológia môže maloobchodníkovi umožniť poznať polohu návštevníka jeho webovej stránky, čo je užitočná funkcia, ktorá im umožňuje zobraziť odhadované prepravné alebo prezentovať ponuky špecifické pre danú polohu. Jedným z najjednoduchších spôsobov, ako ťažiť z geolokácie, je použitie vyhradeného rozhrania API, ktoré môže byť napájané IP adresou a ktoré vráti všetky súvisiace informácie o tejto adrese. Na API ipstack je jeden taký produkt, ktorý sa chystáme objaviťako robí svoju mágiu a čo pre vás môže urobiť. Pozrime sa na základné funkcie nástroja a na jeho použitie. Uvidíme, ako funguje, aký typ dokumentácie a podpory je pre produkt k dispozícii, a pozrieme sa na jeho pomerne jednoduchú štruktúru stanovovania cien.
Predstavujeme ipstack
Jadrom ipstacku je geolokačné API, ktorévyužíva viac vzájomne prepojených poskytovateľov internetových služieb na poskytovanie presných geografických údajov. Zavoláte API z kódu vašej webovej stránky a vráti nepreberné množstvo geografických údajov o používateľoch vašich webových stránok. Získate samozrejme geografickú polohu používateľa (nie je to hlavný bod?), Ale nie je to všetko. Nástroj napríklad vráti odkaz na obrázok vlajky krajiny používateľa alebo na jeho emoji verziu. Ďalej získate informácie o tom, či používateľ pristupuje na vaše stránky prostredníctvom servera proxy. Keď sa pozrieme na dostupné moduly, dôkladne sa o tom všetkom pozrieme.
Projekt, pôvodne nazývaný freegeoip.sieť, videl svetlo v roku 2009 ako iniciatíva open source na pomoc vývojárom. Vďaka neustálemu zlepšovaniu na základe spätnej väzby od používateľov sa o osem rokov neskôr vyvinul v plnohodnotný produkt, na ktorý sa pozeráme. Počas tohto obdobia vzrástla používateľská základňa produktu na vyše sto tisíc spokojných zákazníkov. A nie sú to len zákazníci. Obri ako Microsoft alebo Samsung používajú API. Rovnako tak Airbnb a HubSpot.
API ipstack používa vysoko dynamickú schémuktorá aktualizuje svoju databázu viackrát za deň, čím zabezpečuje integritu vrátených výsledkov. Za týmto účelom sa ipstack spojil s niekoľkými veľkými poskytovateľmi internetových služieb po celom svete. Tento nástroj vykonáva všetku komunikáciu cez 256-bitový kanál šifrovaný SSL - pomocou protokolu HTTPS - aby zabezpečil všetky prenosy údajov. Výsledky môžu byť vrátené pomocou API vo formáte XML alebo JSON, v závislosti od vašich konkrétnych potrieb.
Jednou z najlepších častí API ipstack je jehomodularita. Rôzne dostupné moduly vracajú čoraz viac údajov o polohe používateľa. Vďaka tomu je veľmi flexibilný nástroj. Rýchlosť je tiež jednou z výhod produktu. Volanie API s príslušnými parametrami a požadované výsledky získate veľmi rýchlo. API ipstack v súčasnosti vybavuje viac ako dve miliardy žiadostí denne a stále reaguje takmer okamžite. Vďaka partnerstvu s rôznymi poskytovateľmi internetových služieb môže tento produkt pokrývať asi 2 milióny miest a viac ako dvesto tisíc miest na celom svete. Podporuje aj adresy IPv4 aj IPv6.
Ako funguje geolokácia
Skôr než pôjdeme ďalej, poďme krátko na pauzu arýchlo sa pozrite, ako vyzerá geolokácia. Ako ste asi predpokladali z názvu ipstacku, má to spoločné s IP adresami. IP adresy je možné do istej miery porovnávať s poštovými adresami. Každé zariadenie pripojené na internet má jedinečnú IP adresu. Tieto adresy IP však nie sú náhodne priradené každému zariadeniu. Má v tom nejaký zmysel. Časť adresy IP identifikuje jednotlivé pripojené zariadenie a časť identifikuje sieť, ku ktorej je pripojená. A samotná časť siete je hierarchicky usporiadaná, podobne ako strom adresárov počítačového disku. (Dúfam, že inžinieri medzi našimi čitateľmi mi odpustia toto nadmerné zjednodušenie.)
Je to podobné poštovej adrese s ulicoučíslo, názov ulice, mesto a prípadne krajina. A rovnako ako britská pošta nemá tušenie, kde sa nachádza akákoľvek adresa v USA, pošle poštu USA-USA poštu, ktorá sa postará o smerovanie pošty na správne miesto. A rovnako ako by ste mohli do nástroja, ako je napríklad mapa Google, zadať takmer akúkoľvek poštovú adresu a získať presnú polohu, môžete získať dotaz na nástroj, ako je ipstack API, s adresou IP, aby ste zistili jeho polohu.
To má však určité obmedzenia. Presnú polohu napríklad nezískate z adresy IP. Dostanete to, čo môže poskytnúť poskytovateľ internetových služieb poskytujúci adresu IP. Často to nie je o nič presnejšie ako mesto alebo obec, hoci niektorí poskytovatelia vracajú viac informácií ako iní. Ak používateľ žiada o prístup na vaše webové stránky sieť VPN, z takéhoto vyhľadávania by ste dostali umiestnenie servera VPN, ktorý používajú.
Hlavné vlastnosti API ipstack
Vývojári rozhrania ipstack API sa rozhodli používať amodulárny prístup k tomuto produktu. Pozostáva z rôznych modulov, z ktorých každý vracia iný druh informácií. Existujú napríklad moduly časového pásma, meny alebo dokonca bezpečnosť. Vyberte modul, ktorý sa má použiť, pomocou príslušných parametrov pri odosielaní žiadosti do rozhrania ipstack API.
Tento prístup má niekoľko výhod. Po prvé, uľahčuje spracovanie reakcie. Ak by existoval iba jeden typ žiadosti o vrátenie všetkých dostupných údajov o adrese IP, kód vašej webovej stránky by musel analyzovať celú odpoveď a načítať všetky potrebné informácie. Posielanie menších žiadostí - s menšími odpoveďami - môže tiež zlepšiť výkon.
Pozrime sa hlbšie na každú z dostupných možnostímodul, ako im zavolať a ako vyzerá ich typická odpoveď. Získate tak jasný prehľad o tom, čo môžete od tohto výkonného nástroja očakávať.
Lokalizačný modul
Najzákladnejším modulom rozhrania ipstack API jeModul umiestnenia. Vracia podrobnosti o fyzickom umiestnení adresy IP uvedenej v dotaze. Dostanete krajinu IP adresy, jej hlavný alebo úradný jazyk, ako aj symbol emodži pre vlajku krajiny, ktorý môžete použiť na prispôsobenie používateľského prostredia.
Toto je typická odpoveď na dotaz na rozhranie ipstack API. Prvá časť je súčasťou každého dotazu, bez ohľadu na požadovaný 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
Väčšina vrátených atribútov je samovysvetľujúca, ale ak potrebujete ďalšiu pomoc, na webe ipstack nájdete podrobnú dokumentáciu.
Keďže však hovoríme o lokalizačnom module, pozrime sa, aké ďalšie informácie sa pri jeho používaní vracajú:
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: falseAko vidíte, ďalšie informácie, ktoré získate, súhlavne hlavné mesto krajiny, rôzne jazyky používané na tomto mieste, odkaz na obrázok vlajky krajiny a unicode emodži krajiny.
Menový modul
Mena modul môže byť použitý na ďalšievylepšiť používateľské prostredie webových stránok. Platí to najmä pre nákupné stránky, pretože vám umožňujú zobrazovať ceny v mene používateľa. Poskytnuté podrobnosti zahŕňajú názov a symbol miestnej meny, ako aj jej množné číslo. Rozhranie API samozrejme neprevedie ceny na správnu menu, ale umožní vám použiť ďalšie rozhranie API na prevod cien do správnej meny pre vašich návštevníkov. Pozrime sa, ako vyzerá výstup z menového modulu:
currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"Bezpečnostný modul
Pravdepodobne nie tak populárne - alebo užitočné - ako predchádzajúcemodulov, bezpečnostný modul je stále zaujímavý. Vracia informácie o niekoľkých aspektoch zabezpečenia prichádzajúceho pripojenia. Napríklad vám povie, či je stránka prístupná prostredníctvom servera proxy, a ak je to tak, typ servera proxy alebo či žiadosť prišla prostredníctvom siete tor. Môže vám tiež povedať, že žiadosť pochádza skôr z prehľadávača než zo skutočného používateľa. Tento druh informácií možno použiť na zabránenie zoškrabania. Modul tiež vracia úroveň hrozby spojenú s poskytnutou IP adresou, čo potenciálne umožňuje hrubú ochranu pred škodlivými požiadavkami. Uvádzame typické reakcie bezpečnostného modulu:
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: nullModul časového pásma
Ďalší modul, ktorý môže byť užitočnýprispôsobte si dojem návštevníkov vašich webových stránok pomocou modulu Časové pásmo. Vracia niektoré ďalšie podrobnosti o návštevníkoch vašich webových stránok. Jedným z miest, kde by ste mohli takúto funkciu použiť na stránkach, ktoré sa zaoberajú časovo citlivými informáciami. Umožňuje vám zobraziť správny čas na základe polohy vašich používateľov.
Modul poskytuje informácie, ako je posun GMT, aktuálny čas používateľa, časový kód a umiestnenie časového pásma, ako môžete vidieť z tejto ukážkovej odpovede:
time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: truePripojovací modul
V neposlednom rade je pripojovací modul. Tento je skôr zjednodušený. Vracia sa iba číslo autonómneho systému (AS) priradené k zdrojovej IP adrese a názvu ISP. Je to vlastne meno vlastníka AS, a nie ISP. Niektoré organizácie registrujú svoj vlastný autonómny systém, ako je to v nasledujúcom príklade:
connection: Object{}
asn: 395399
isp: "City of Montreal"Toto je pravdepodobne najmenej užitočné zo všetkých modulov, ale niektoré ho považujú za užitočné na rôzne analytické účely.
Práca s API ipstack
Preskúmali sme, aké informácie môžu byťvrátené rozhraním API ipstack, teraz je čas sa pozrieť, ako sa nazýva. Rozhranie API ipstack ponúka tri rôzne typy dopytov, z ktorých každý má odlišné parametre. K dispozícii je štandardné vyhľadávanie, hromadné vyhľadávanie a vyhľadávanie žiadateľov. Pozrime sa, ako sa líšia. Je to pekná funkcia, pretože napríklad hromadná požiadavka umožňuje spojiť niekoľko žiadostí do jednej, čím sa zníži celková réžia a umožní rýchlejšie výsledky. Pozrime sa podrobnejšie na každý typ žiadosti.
Štandardné vyhľadávanie
Ako ste asi uhádli, štandardné vyhľadávanie jenajzákladnejší. Vracia podrobnosti o jednej adrese IP, ktoré ste uviedli pri volaní rozhrania ipstack API. Jeho používanie je veľmi jednoduché a bude fungovať s adresami IPv4 alebo IPv6. Aby sa veci ešte zjednodušili, dokumentácia k produktu poskytuje vzorový kód pre štandardnú požiadavku v PHP (cURL) aj JavaScripte (Jquery.ajax). Ak sa vaše webové stránky zostavujú pomocou niektorého z týchto prvkov, používanie rozhrania API je skutočne nezvratné. Tu je ukážka typického volania do rozhrania API pomocou jednoduchého kódu HTML:
https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY
V tomto príklade YOUR_ACCESS_KEY bude nahradený skutočným prístupovým kľúčom, ktorý ste použilipri registrácii do služby. V tomto príklade by ste uviedli aj skutočnú adresu IP, o ktorej chcete získať informácie, a nie fiktívnu adresu.
Výsledky štandardného vyhľadávania zahŕňajú všetkymoduly v predvolenom nastavení, ale ďalšie parametre vám umožňujú vyladiť požiadavku podľa vašich konkrétnych potrieb. Všetky podrobnosti o dostupných parametroch sú jasne vysvetlené v dokumentácii k produktu. Podobne je predvolenou odpoveďou objekt JSON, ale parametre ho môžu zmeniť na formát XML.
Hromadné vyhľadávanie a vyhľadávanie žiadateľov
Hromadné vyhľadávanie vám umožňuje vyžiadať si údaje protiviac IP adries v rámci jednej žiadosti. Rovnako ako v prípade štandardného vyhľadávania môžete získať údaje na adrese IPv4 aj IPv6. V jednej žiadosti môžete kombinovať obidva typy adries. Formát žiadosti je rovnaký ako formát štandardného vyhľadávania s tým rozdielom, že zadáte viac adries IP oddelených čiarkami.
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
Posledný typ žiadosti, ktorú ponúka ipstackAPI je vyhľadávanie žiadateľov. Vráti informácie o IP adrese, z ktorej žiadosť prichádza. Je to typ žiadosti, ktorú by ste spustili prostredníctvom skriptu na strane klienta. Pri volaní na vyhľadávanie žiadateľov stačí použiť IP adresu namiesto kľúčového slova „check“. Ostatné dostupné parametre požiadavky sú rovnaké ako pre iné typy požiadaviek.
https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY
Ako funguje rozhranie ipstack API?
API ipstack je niečo viac ako pravdepodobnéintegrovali by ste sa do webovej stránky v reálnom čase. Napríklad by ste mohli chcieť poskytovať iný obsah na základe polohy klienta. Aby ste to dosiahli, potrebujete rozhranie API, ktoré bude fungovať neuveriteľne rýchlo. Akékoľvek oneskorenie v odozve rozhrania API sa premietne do oneskorení zobrazujúcich stránku vášmu klientovi, čomu by ste sa viac než pravdepodobne chceli vyhnúť. To isté platí bez ohľadu na to, na čo používate údaje o polohe. Preto je čas odozvy nástroja, ktorý používate, nanajvýš dôležitý. Aj keď geolokačné API môže poskytnúť toľko potrebnú funkčnosť, jeho zlyhanie môže mať katastrofálny dopad.
Z týchto dôvodov musíte zvoliť rozhranie APIdobrá doba odozvy. Vykonali sme veľa úsilia pri testovaní rôznych scenárov a vykonali sme testy s jednou alebo viacerými adresami IP, niektoré s viacerými voliteľnými parametrami, iné s menšou hodnotou. S výsledkami sme boli veľmi spokojní a dostali sme dosť konzistentnú reakčnú dobu okolo 100 ms, bez ohľadu na požiadavku. Reakcia bola tiež konzistentná v priebehu času bez zjavných „špičkových hodín“, kedy by výkon utrpel, a bola podobná bez ohľadu na to, odkiaľ sme začali žiadosti. Zdá sa, že servery ipstack sú navrhnuté tak, aby zvládli zaťaženie, ktoré dostanú. Celkovo sa zdá, že používanie rozhrania API ipstack nemá takmer žiadny vplyv na reakciu webových stránok z pohľadu používateľa.
Dokumentácia a podpora produktu
Často sa hovorí, že výrobok je iba taký dobrýako jeho dokumentácia. Ak je to pravda, rozhranie ipstack API sa nemusí báť, pretože jeho dokumentácia sa dá ľahko nájsť, používať a porozumieť. Kvalita dokumentácie tiež udáva, do akej miery sa vydavateľ softvéru stará o svojich používateľov. Tu sa opäť nemusíme obávať.
Jedna z najlepších vecí na tomto produktedokumentácia je, napodiv, také malé. Všetko sa zmestí na jednu dobre usporiadanú webovú stránku, na ktorej ľahko nájdete všetko, čo potrebujete. A aby bola vec ešte jednoduchšia, panel s ponukami uľahčí prístup do ktorejkoľvek danej sekcie. Dokumentácia pokrýva všetko od použitia rôznych typov žiadostí až po prispôsobenie odpovede.
Vo veľmi nepravdepodobnom prípade, keď by ste tak neurobilinájdete v dokumentácii to, čo potrebujete, podpora je tiež k dispozícii. Začiatku môže trvať nejaký čas, kým sa dostane k technickej podpore, ale akonáhle tak urobíte, reagujú pomerne rýchlo.
stanovenie ceny
K dispozícii je niekoľko cenových plánovAPI ipstack. Na najnižšej úrovni je zadarmo plán. Ako už názov napovedá, tento je zadarmo. Je tiež trochu obmedzený. Pre začiatočníkov môžete spúšťať až 10 000 dopytov mesačne. Zahŕňa tiež iba lokalizačný modul a prístup k podpore je obmedzený. Môže to však byť skvelý spôsob, ako otestovať produkt a zistiť, ako sa môže integrovať do vášho prostredia.
Ďalšou úrovňou je základný plán. Ten predáva za 9,99 dolárov mesačne alebo 95,90 dolárov ročne (zľava 20%) a limit žiadostí sa tak zvyšuje až na 50 000 / mesiac. Umožňuje tiež používať moduly Mena, Časové pásmo a Pripojenie. Súčasťou plánu je tiež zvýšená podpora, ako aj zvýšená bezpečnosť pomocou šifrovania SSL.
Najobľúbenejší plán je profesionálnyktorá predáva za 49,99 dolárov mesačne alebo 479,90 dolárov ročne. Poskytuje vám všetko, čo je obsiahnuté v základnom pláne, ale zvyšuje limit mesačných požiadaviek na 500 000 a zahŕňa aj možnosť hromadných žiadostí.
Na vrchole je profesionálny plus plán. Stojí to 99,99 dolárov mesačne alebo 959,90 dolárov ročne. Je totožný s profesionálnym plánom, umožňuje však až 2 milióny žiadostí mesačne a je jediným plánom, ktorý obsahuje bezpečnostný modul.
Ak to nestačí, existuje ajprispôsobiteľný podnikateľský plán, ktorý je možné usporiadať kontaktovaním ipstacku. Môže obsahovať toľko mesačných požiadaviek, koľko potrebujete, ako aj rôzne vlastné riešenia založené na konkrétnych potrebách klienta.
Na záver
Rozhranie ipstack API je vynikajúci produktumožňujú vám rýchlo a ľahko získať čo najviac údajov, ktoré môžete získať z adresy IP. Má úžasný čas odozvy, vynikajúcu dokumentáciu a dobrú podporu, vďaka ktorej je táto hodnota pre peniaze skvelá. Aj samotná skutočnosť, že ju používajú viacerí internetoví giganti, je pravdepodobne dobrým dôkazom hodnoty produktu.
Toto je určite produkt, ktorý by som odporučiluvažujete o využití údajov, ktoré je možné zhromaždiť pre adresu IP návštevníka vášho webu. A keďže je k dispozícii bezplatný - hoci obmedzený - plán, nie je dôvod, prečo by ste ho nemali aspoň vyskúšať, aby ste sami videli, čo pre vás môže urobiť.
Komentáre