Od svých skromných začátků před více než 25 letyCelosvětový web se vyvinul způsoby, které nemohli ani ti nejlepší analytici nikdy předvídat. Z formy, která byla v podstatě nástrojem, který vědcům pomáhá sdílet informace, se vyvinul do spotřebitelského nástroje, bez kterého by mnozí z nás prostě nemohli žít. Změnilo to mnoho aspektů našeho života a my jsme se na to spolehli, možná víc, než bychom měli. Stalo se tak běžné, že mění maloobchod. Z velkých řetězců kamenných obchodů jsou nyní nejlepší maloobchodníci internetovými tržišti.
Aby byli maloobchodníci online úspěšní, potřebují nejenbýt přítomen na webu, ale také musí plně využívat jeho funkce. Jednou z takových funkcí je geolokace. Tato technologie může maloobchodníkovi umožnit znát polohu návštěvníka svého webu, což je užitečná funkce, která jim umožní zobrazit odhadované přepravné nebo prezentovat nabídky specifické pro danou lokalitu. Jedním z nejjednodušších způsobů, jak těžit z geolokace, je použití vyhrazeného API, které může být napájeno IP adresou a které vrací veškeré příslušné informace o této adrese. The API ipstack je jeden takový produkt, který se chystáme objevitjak to dělá jeho kouzlo a co pro vás může udělat. Podíváme se na základní funkčnost nástroje a na jeho použití. Uvidíme, jak funguje, jaký typ dokumentace a podpory je pro produkt k dispozici, a podíváme se na jeho poměrně jednoduchou cenovou strukturu.
Představujeme ipstack
Ve svém jádru je ipstack geolokační API, kterépoužívá více vzájemně propojených poskytovatelů internetu k poskytování přesných geografických dat. Zavoláte rozhraní API z kódu svého webu a vrátí množství geografických údajů o uživatelích vašeho webu. Získáte samozřejmě geografickou polohu uživatele (není to hlavní bod?), Ale to není vše. Nástroj například vrátí odkaz na obrázek příznaku země uživatele nebo na jeho emoji verzi. Dále získáte informace o tom, zda uživatel přistupuje na váš web prostřednictvím serveru proxy. Vše se podíváme podrobněji, když se podíváme na podrobnější informace o dostupných modulech.
Projekt, původně nazývaný freegeoip.net, viděl světlo zpět v roce 2009 jako open source iniciativa na pomoc vývojářům. Díky neustálému zlepšování na základě zpětné vazby od uživatelů se o osm let později vyvinul v plnohodnotný produkt, na který se díváme. Během této doby vzrostla uživatelská základna produktu na více než sto tisíc spokojených zákazníků. A nejsou to jen zákazníci. Obři jako Microsoft nebo Samsung používají API. Stejně tak Airbnb a HubSpot.
API ipstack používá vysoce dynamické schémakterý aktualizuje svou databázi vícekrát denně, čímž zajišťuje integritu vrácených výsledků. Za tímto účelem se ipstack spojil s několika velkými poskytovateli internetových služeb po celém světě. Tento nástroj provádí veškerou komunikaci přes 256bitový kanál šifrovaný SSL - pomocí HTTPS - pro zajištění všech datových přenosů. Výsledky mohou být vráceny API ve formátu XML nebo JSON, v závislosti na vašich konkrétních potřebách.
Jednou z nejlepších částí API ipstacku je jehomodularita. Různé dostupné moduly vracejí stále více údajů o poloze uživatele. Díky tomu je velmi flexibilní nástroj. Rychlost je také jednou z předností produktu. Voláte API s příslušnými parametry a dostanete požadované výsledky super rychle. V současné době API ipstack zpracovává více než dvě miliardy požadavků denně a stále reaguje téměř okamžitě. Prostřednictvím partnerství s různými poskytovateli internetových služeb může produkt pokrýt přibližně 2 miliony míst a více než dvě stě tisíc měst po celém světě. Podporuje také adresy IPv4 i IPv6.
Jak funguje geolokace
Než půjdeme dál, pojďme krátce pauzu apodívejte se, jak vypadá geolokace. Jak byste asi hádali z názvu ipstacku, souvisí to s IP adresami. IP adresy lze do jisté míry srovnávat s poštovními adresami. Každé zařízení připojené k internetu má jedinečnou IP adresu. Tyto adresy IP však nejsou každému zařízení přiřazeny pouze náhodně. Je v tom nějaký smysl. Část adresy IP identifikuje jednotlivé připojené zařízení a část identifikuje síť, ke které je připojena. A samotná síťová část je hierarchicky uspořádána, poněkud jako strom adresáře počítačového disku. (Doufám, že inženýři mezi našimi čtenáři mi odpustí za toto přílišné zjednodušení.)
Je to podobné poštovní adrese s ulicíčíslo, název ulice, město a nakonec země. A stejně jako britská pošta nemá tušení, kde se nachází jakákoli adresa v USA, pošle poštu vázanou na USA USPS, která se postará o směrování pošty na správné místo. A stejně jako byste mohli do nástroje, jako je Google mapa, zadat téměř jakoukoli poštovní adresu a získat přesné odpovídající umístění, můžete dotazovat nástroj, jako je ipstack API, s IP adresou, abyste zjistili jeho umístění.
To má však určitá omezení. Například přesnou adresu nezískáte z IP adresy. Dostanete cokoli, co může poskytnout poskytovatel internetových služeb poskytující IP adresu. To často není o nic přesnější než město nebo obecní sousedství, i když někteří poskytovatelé vracejí více informací než jiní. Pokud uživatel žádá VPN o přístup na váš web, získáte tím, co z takového vyhledávání získáte, umístění VPN serveru, který používají.
Hlavní vlastnosti API ipstack
Vývojáři API ipstacku se rozhodli použít amodulární přístup k tomuto produktu. Skládá se z různých modulů, z nichž každý vrací jiný typ informací. Existují například moduly časového pásma, měny nebo dokonce zabezpečení. Vyberte modul, který chcete použít, pomocí příslušných parametrů při odesílání žádosti do rozhraní ipstack API.
Tento přístup má několik výhod. Nejprve usnadňuje zpracování reakce. Pokud by existoval pouze jeden typ požadavku na vrácení všech dostupných údajů o IP adrese, kód vašeho webu by musel analyzovat celou odpověď a načíst veškeré informace, které potřebuje. Posílání menších požadavků - s menšími odpověďmi - může také zlepšit výkon.
Podívejme se hlouběji na každou z dostupných možnostímodul, jak jim zavolat a jak vypadá jejich typická odpověď. To vám poskytne poměrně jasný přehled toho, co lze od tohoto výkonného nástroje očekávat.
Modul umístění
Nejzákladnějším modulem rozhraní ipstack API jeModul umístění. Vrací podrobnosti o fyzickém umístění IP adresy uvedené v dotazu. Získáte adresu IP, zemi, její hlavní nebo oficiální jazyk a také symbol emodži pro vlajku země, který můžete použít k přizpůsobení uživatelského prostředí.
Zde je typická odpověď na dotaz na rozhraní ipstack API. První část je součástí každého dotazu, bez ohledu 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ětšina vrácených atributů je samozřejmá, ale pokud potřebujete další pomoc, máte podrobnou dokumentaci na webu ipstacku.
Jelikož ale hovoříme o lokalizačním modulu, podívejme se, jaké zvláštní informace se při použití vrátí:
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: falseJak vidíte, další informace, které získáte, jsouhlavně hlavní město země, různé jazyky používané v dané lokalitě, odkaz na obrázek vlajky země a unicode emodži země.
Měnový modul
Měnový modul lze použít k dalšímuvylepšit uživatelské prostředí vašeho webu. To platí zejména pro nákupní web, protože vám umožní zobrazovat ceny v měně uživatele. Poskytnuté údaje zahrnují název a symbol místní měny a její množné číslo. Rozhraní API samozřejmě nepřevádí ceny do správné měny, ale umožní vám použít jiné rozhraní API k převodu cen na správnou měnu pro vaše návštěvníky. Podívejme se, jak vypadá výstup z měnového modulu:
currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"Bezpečnostní modul
Pravděpodobně ne tak populární - nebo užitečný - jako předchozímodulů, modul Security je stále zajímavý. Vrací informace o několika bezpečnostních aspektech příchozího připojení. Například vám řekne, zda je k webu přistupováno prostřednictvím serveru proxy, a pokud ano, typ serveru proxy nebo zda požadavek přišel prostřednictvím sítě tor. Může vám také sdělit, že požadavek pochází spíše od prolézacího modulu než od skutečného uživatele. Tento typ informací lze použít k zabránění poškrábání. Modul také vrací úroveň hrozby související s poskytnutou IP adresou, což potenciálně umožňuje hrubou ochranu před škodlivými požadavky. Tady je typická reakce modulu Security:
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
Další modul, který se může hoditpřizpůsobte si uživatelské prostředí návštěvníků vašeho webu modul Časové pásmo. Vrací některé další podrobnosti o návštěvnících vašeho webu - uhodli jste to. Jedním z míst, kde byste mohli takovou funkci použít na webech, které se zabývají časově citlivými informacemi. To vám umožní zobrazit správný čas na základě polohy vašich uživatelů.
Modul poskytuje informace, jako je posun GMT, aktuální uživatelský čas, časový kód a umístění časového pásma, jak můžete vidět z této ukázkové odpovědi:
time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: truePřipojovací modul
V neposlední řadě je připojovací modul. Tenhle je spíše zjednodušující. Vrací pouze číslo autonomního systému (AS) přidružené ke zdrojové IP adrese a názvu ISP. Je to vlastně jméno vlastníka AS, spíše ISP. Některé organizace registrují svůj vlastní autonomní systém, jak je tomu v příkladu níže:
connection: Object{}
asn: 395399
isp: "City of Montreal"To je pravděpodobně nejméně užitečné ze všech modulů, ale některé to považují za užitečné pro různé analytické účely.
Práce s API ipstack
Podívali jsme se, jaké informace mohou býtvrácené API ipstack API, nyní je čas se podívat, jak se tomu říká. API ipstack API nabízí tři různé typy dotazů, z nichž každý má různé parametry. K dispozici je standardní vyhledávání, hromadné vyhledávání a vyhledávání žadatelů. Uvidíme, jak se liší. To je pěkná funkce, protože například hromadný požadavek umožňuje spojit několik požadavků do jednoho, čímž se sníží celková režie a umožní rychlejší výsledky. Podívejme se hlouběji na každý typ požadavku.
Standardní vyhledávání
Jak jste možná uhodli, standardní vyhledávání jenejzákladnější. Vrací podrobnosti o jediné adrese IP, které zadáte při volání API ipstack. Používání je velmi jednoduché a bude fungovat s adresami IPv4 nebo IPv6. Aby to bylo ještě jednodušší, dokumentace produktu poskytuje ukázkový kód pro standardní požadavek v PHP (cURL) i JavaScript (Jquery.ajax). Pokud je váš web vytvořen pomocí některého z nich, používání rozhraní API je opravdu nevhodné. Zde je ukázka typického volání API pomocí jednoduchého kódu HTML:
https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY
V tomto příkladu YOUR_ACCESS_KEY by byl nahrazen skutečným přístupovým klíčem, který jste použilikdyž se přihlásíte ke službě. V tomto příkladu byste také zahrnuli skutečnou IP adresu, o které chcete získat informace, nikoli fiktivní.
Výsledky standardního vyhledávání zahrnují všechnymoduly ve výchozím nastavení, ale další parametry vám umožní vyladit požadavek přesně podle vašich potřeb. Všechny podrobnosti o dostupných parametrech jsou jasně vysvětleny v dokumentaci k produktu. Podobně je výchozí odpovědí objekt JSON, ale parametry jej mohou změnit na formát XML.
Hromadné a vyhledávací vyhledávání
Hromadné vyhledávání vám umožňuje vyžádat si data protivíce IP adres v rámci jednoho požadavku. Stejně jako standardní vyhledávání můžete získat data jak na adresách IPv4, tak IPv6. Můžete dokonce kombinovat oba typy adres do jedné žádosti. Formát požadavku je stejný jako u standardního vyhledávání s výjimkou, že zadáte více IP adres oddělených čárkami.
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 požadavku, který nabízí ipstackAPI je vyhledávání žadatelů. Vrátí informace o IP adrese, ze které požadavek přichází. Je to typ požadavku, ze kterého byste museli spouštět skript na straně klienta. Chcete-li zavolat vyhledávací dotaz, stačí použít místo adresy IP klíčové slovo „check“. Ostatní dostupné parametry požadavku jsou stejné jako u jiných typů požadavků.
https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY
Jak funguje rozhraní ipstack API?
API ipstack je něco více než pravděpodobnéintegrovali byste se do webových stránek v reálném čase. Můžete například chtít zobrazovat jiný obsah na základě polohy klienta. Aby toho bylo možné dosáhnout, potřebujete API, aby fungovalo ohromně rychle. Jakékoli zpoždění v odezvě API se projeví ve zpoždění zobrazujících stránku vašemu klientovi, čemu byste se více než pravděpodobné chtěli vyhnout. Totéž platí bez ohledu na to, pro co používáte údaje o poloze. Proto je doba odezvy nástroje, který používáte, nanejvýš důležitá. I když rozhraní geolokace API může poskytovat tolik potřebné funkce, jeho selhání může mít katastrofální dopad.
Z těchto důvodů musíte vybrat rozhraní APIdobrá doba odezvy. Provedli jsme hodně úsilí při testování různých scénářů a provedli jsme testy s jednou nebo více adresami IP, některé s více volitelnými parametry, jiné s méně. S výsledky jsme byli docela spokojeni a dostali jsme poměrně konzistentní dobu odezvy přibližně 100 ms, bez ohledu na požadavek. Odezva byla také konzistentní v průběhu času bez zjevných „špiček“, kdy by výkon trpěl, a bylo to podobné bez ohledu na to, odkud jsme žádosti vyřizovali. Vypadá to, že servery ipstack jsou vytvořeny tak, aby zvládly zatížení, které získají. Celkově se zdá, že použití rozhraní ipstack API mělo sotva jakýkoli účinek na reakci na web z pohledu uživatele.
Dokumentace a podpora produktu
Často se říká, že produkt je jen tak dobrýjako její dokumentace. Pokud je to pravda, API ipstack se nemusí čeho bát, protože jeho dokumentaci lze snadno najít, použít a pochopit. Kvalita dokumentace také udává, do jaké míry se vydavatel softwaru stará o své uživatele. Tady opět není čeho se obávat.
Jedna z nejlepších věcí na tomto produktudokumentace je, kupodivu, jak málo je. Všechno se hodí na jednu dobře rozloženou webovou stránku, na které snadno najdete vše, co potřebujete. A aby to bylo ještě jednodušší, podokno nabídky umožňuje snadný přístup do kterékoli dané sekce. Dokumentace pokrývá vše od použití různých typů požadavků až po přizpůsobení odpovědi.
Ve velmi nepravděpodobném případě, kdy byste to tak nebyliv dokumentaci naleznete, co potřebujete, podpora je také k dispozici. Zpracování technické podpory může chvíli trvat, ale jakmile to uděláte, reagují poměrně rychle.
Ceny
K dispozici je několik cenových plánůAPI ipstack. Na nejnižší úrovni je zdarma plán. Jak jeho název napovídá, tento je zdarma. Je také poněkud omezený. Pro začátečníky můžete spouštět až 10 000 dotazů měsíčně. Zahrnuje také pouze lokalizační modul a přístup k podpoře je omezený. Může to však být skvělý způsob, jak produkt otestovat a zjistit, jak se může integrovat do vašeho prostředí.
Další úroveň je základní plán. Ten prodává za 9,99 $ / měsíc nebo 95,90 $ / rok (20% sleva) a přináší limit požadavků až na 50 000 / měsíc. Umožňuje také použití modulů Měna, Časové pásmo a Připojení. Součástí plánu je také rozšířená podpora, jakož i zvýšená bezpečnost pomocí šifrování SSL.
Nejoblíbenějším plánem je profesionálníkterý prodává za 49,99 $ / měsíc nebo 479,90 $ / rok. Poskytuje vám vše, co je zahrnuto v základním plánu, ale zvyšuje limit měsíčních požadavků na 500 000 a zahrnuje také možnost provádět hromadné žádosti.
Nahoře je profesionální plus plán. Stojí to 99,99 $ / měsíc nebo 959,90 $ / rok. Je totožný s profesionálním plánem, ale umožňuje až 2 miliony požadavků měsíčně a je jediným plánem, který obsahuje bezpečnostní modul.
Pokud to nestačí, existuje taképřizpůsobitelný podnikový plán, který lze uspořádat kontaktováním ipstacku. Může zahrnovat tolik měsíčních požadavků, kolik potřebujete, a také různá vlastní řešení založená na konkrétních potřebách klienta.
Na závěr
Ipstack API je vynikající produkt, který budeumožní vám rychle a snadno získat co nejvíce dat, která můžete získat z IP adresy. To má úžasnou dobu odezvy, vynikající dokumentaci a dobrou podporu, které dohromady, aby to skvělou hodnotu za peníze. Také samotná skutečnost, že ji používá několik internetových gigantů, je pravděpodobně dobrým důkazem hodnoty produktu.
To je určitě produkt, který bych doporučilhledáte využití dat, která lze shromáždit pro IP adresu návštěvníka vašeho webu. A protože je k dispozici bezplatný - i když omezený - plán, není důvod, proč byste ho neměli alespoň vyzkoušet, abyste sami viděli, co pro vás může udělat.
Komentáře