Kopš tās pazemīgajiem pirmsākumiem pirms vairāk nekā 25 gadiem,globālais tīmeklis ir attīstījies tā, ka pat labākie analītiķi nekad nebūtu varējuši paredzēt. Tā kā tas būtībā bija līdzeklis, kas palīdz pētniekiem dalīties ar informāciju, tas ir kļuvis par patērētāju rīku, bez kura daudzi no mums vienkārši nevar iztikt. Tas ir mainījis daudzus mūsu dzīves aspektus, un mēs esam uz to paļāvušies, iespējams, vairāk nekā vajadzētu. Tas ir kļuvis tik ikdienišķs, ka maina mazumtirdzniecības nozari. No lielajām ķieģeļu un javas veikalu ķēdēm lielākie mazumtirgotāji tagad ir tīmekļa vietnes.
Lai gūtu panākumus, tiešsaistes mazumtirgotājiem ir nepieciešams ne tikaibūt klāt tīmeklī, taču viņiem arī pilnībā jāizmanto tā iespējas. Viena no šādām iezīmēm ir ģeogrāfiskās atrašanās vietas noteikšana. Šī tehnoloģija ļauj mazumtirgotājam uzzināt savas vietnes apmeklētāja atrašanās vietu, kas ir noderīga funkcija, kas ļauj parādīt aptuvenās piegādes izmaksas vai iesniegt konkrētai vietai raksturīgus piedāvājumus. Viens no vienkāršākajiem veidiem, kā gūt labumu no ģeogrāfiskās atrašanās vietas noteikšanas, ir izmantot speciālu API, kuru var barot ar IP adresi un kas atgriezīs visu būtisko informāciju par šo adresi. Uz ipstack API ir viens no šādiem produktiem, un mēs to gatavojamies atklātkā tā dara savu maģiju un ko tā var darīt jūsu labā. Mēs apskatīsim rīka pamata funkcionalitāti, kā arī to, kā to izmantot. Mēs redzēsim, kā tas darbojas, kāda veida dokumentācija un atbalsts ir pieejams izstrādājumam, un apskatīsim tā diezgan vienkāršo cenu struktūru.
Iepazīstinām ar ipstack
Tās pamatā ipstack ir ģeogrāfiskās atrašanās vietas noteikšanas API, kasizmanto vairākus savstarpēji savienotus ISP, lai nodrošinātu precīzus ģeogrāfiskos datus. Jūs izsaucat API no savas vietnes koda, un tas atgriezīs pārpilnību ģeogrāfisko datu par jūsu vietnes lietotājiem. Jūs, protams, uzzināsit lietotāja ģeogrāfisko atrašanās vietu (vai tas nav galvenais?), Bet tas vēl nav viss. Piemēram, rīks atgriezīs saiti uz lietotāja valsts karoga attēlu vai tā emocijveida versiju. Turklāt jūs iegūsit informāciju par to, vai lietotājs piekļūst jūsu vietnei, izmantojot starpniekserveri. Mēs izpētīsim dziļāku informāciju par šo visu, jo mēs izpētīsim dziļāku informāciju par pieejamajiem moduļiem.
Projekts, kas sākotnēji tika saukts par freegeoip.net, redzēja gaismu jau 2009. gadā kā atvērtā koda iniciatīva, lai palīdzētu izstrādātājiem. Nepārtraukti uzlabojot, pamatojoties uz lietotāju atsauksmēm, aptuveni astoņus gadus vēlāk tas pārtapa par pilnvērtīgu produktu, kuru mēs apskatām. Šajā laikā produkta lietotāju bāze pieauga līdz vairāk nekā simts tūkstošiem apmierinātu klientu. Viņi nav tikai klienti. Milži, piemēram, Microsoft vai Samsung, izmanto API. Tā ir Airbnb un HubSpot.
Ipstack API izmanto ļoti dinamisku shēmukas atjaunina savu datu bāzi vairākas reizes dienā, nodrošinot atgriezto rezultātu integritāti. Šim nolūkam ipstack sadarbojas ar vairākiem lieliem ISP visā pasaulē. Rīks veic visu komunikāciju, izmantojot 256 bitu SSL šifrētu kanālu, izmantojot HTTPS, lai nodrošinātu visu datu pārsūtīšanu. Rezultātus API var atgriezt XML vai JSON formātā atkarībā no jūsu īpašajām vajadzībām.
Viena no labākajām ipstack API daļām ir tāmodularitāte. Dažādi pieejamie moduļi atgriež arvien vairāk datu par lietotāja atrašanās vietu. Tas padara ļoti elastīgu instrumentu. Ātrums ir arī viens no produkta priekšrocībām. Jūs izsaucat API ar atbilstošo (-iem) parametru (-iem) un pieprasītos rezultātus sasniedzat ļoti ātri. Pašlaik ipstack API katru dienu apstrādā vairāk nekā divus miljardus pieprasījumu, un tas joprojām atbild gandrīz uzreiz. Sadarbojoties ar dažādiem ISP, produkts var aptvert aptuveni 2 miljonus vietu un vairāk nekā divsimt tūkstošus pilsētu visā pasaulē. Tas atbalsta arī IPv4 un IPv6 adreses.
Kā darbojas ģeogrāfiskā atrašanās vieta
Pirms mēs dodamies tālāk, īsi apstādinām unātri apskatiet, kā izskatās ģeogrāfiskā atrašanās vieta. Kā jūs uzminējāt no ipstack nosaukuma, tam ir sakars ar IP adresēm. IP adreses zināmā mērā var salīdzināt ar pasta adresēm. Katrai ar internetu savienotai ierīcei ir unikāla IP adrese. Bet šīs IP adreses ne tikai nejauši tiek piešķirtas katrai ierīcei. Tajā ir kāda jēga. Daļa IP adreses identificē atsevišķu pievienoto ierīci, bet daļa identificē tīklu, kuram tā ir pievienota. Un pati tīkla daļa ir hierarhiski organizēta, nedaudz līdzīga datora diska direktoriju kokam. (Es ceru, ka mūsu lasītāju inženieri man piedos par šo pārāk vienkāršošanu.)
Tas ir līdzīgi pasta adresei ar ielunumurs, ielas nosaukums, pilsēta un, visbeidzot, valsts. Un tāpat kā Lielbritānijas pastam nav ne jausmas, kur atrodas jebkura ASV adrese, tas nosūtīs uz ASV iesūtītu pastu USPS, kas rūpēsies par pasta novirzīšanu pareizajā vietā. Un tāpat kā jūs varētu ievadīt diezgan daudz jebkura pasta adreses tādā rīkā kā Google map un iegūt precīzu atbilstošo atrašanās vietu, jūs varat meklēt rīku, piemēram, ipstack API, ar IP adresi, lai iegūtu tā atrašanās vietu.
Tomēr tam ir daži ierobežojumi. Piemēram, no IP adreses jūs nesaņemsit precīzu atrašanās vietu. Jūs saņemsiet visu, ko var sniegt ISP, kas piegādā IP adresi. Tas bieži vien nav daudz precīzāks nekā pilsēta vai rajons, kaut arī daži pakalpojumu sniedzēji sniedz vairāk informācijas nekā citi. Turklāt, ja lietotājs iesūdz VPN, lai piekļūtu jūsu vietnei, no šāda uzmeklēšanas jūs iegūstat izmantotā VPN servera atrašanās vietu.
Ipstack API galvenās iezīmes
Ipstack API izstrādātāji izvēlējās izmantot amodulāra pieeja šim produktam. Tas sastāv no dažādiem moduļiem, no kuriem katrs sniedz cita veida informāciju. Piemēram, ir laika joslas, valūtas vai pat drošības moduļi. Jūs izvēlaties izmantojamo moduli, izmantojot atbilstošos parametrus, nosūtot pieprasījumu uz ipstack API.
Šai pieejai ir dažas priekšrocības. Pirmkārt, tas atvieglo atbildes reakciju. Ja bija tikai viena veida pieprasījums, ar kuru tika atgriezti visi pieejamie dati par IP adresi, jūsu vietnes kodam būs jāatspoguļo visa atbilde, lai iegūtu visu nepieciešamo informāciju. Arī mazāku pieprasījumu nosūtīšana ar mazākām atbildēm var uzlabot veiktspēju.
Apskatīsim padziļināti katru no pieejamajiemmoduli, kā viņiem piezvanīt un kā izskatās viņu tipiskā atbilde. Tas sniegs diezgan skaidru pārskatu par to, ko sagaidīt no šī jaudīgā rīka.
Vietas modulis
Ipstack API visvienkāršākais modulis irVietas modulis. Tas atgriež informāciju par vaicājumā norādītās IP adreses fizisko atrašanās vietu. Jūs saņemsit IP adreses valsti, tās galveno vai oficiālo valodu, kā arī emocijzīmi ar valsts karogu, kuru varat izmantot, lai personalizētu lietotāja pieredzi.
Šeit ir raksturīga atbilde uz vaicājumu uz ipstack API. Pirmā daļa ir iekļauta jebkurā vaicājumā neatkarīgi no pieprasītā moduļa:
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
Lielākā daļa atdoto atribūtu ir pašsaprotami, taču, ja jums nepieciešama papildu palīdzība, jums ir detalizēta dokumentācija ipstack vietnē.
Bet, tā kā mēs runājam par atrašanās vietas moduli, apskatīsim, kāda papildu informācija tiek atgriezta, to izmantojot:
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: falseKā redzat, iegūtā papildu informācija irgalvenokārt valsts galvaspilsētu, dažādās valodas, kuras tiek izmantotas šajā vietā, saiti uz valsts karoga attēlu un šīs valsts emocijzīmes unikodu.
Valūtas modulis
Valūtas moduli var izmantot, lai turpinātuuzlabot vietnes lietotāju pieredzi. Īpaši tas attiecas uz iepirkšanās vietni, jo tā ļaus jums parādīt cenas lietotāja valūtā. Sniegtajā informācijā ietilpst vietējās valūtas nosaukums un simbols, kā arī tās daudzskaitļa nosaukums. API, protams, nepārveidos cenas pareizajā valūtā, taču tā ļaus jums izmantot citu API, lai konvertētu cenas apmeklētāju pareizajā valūtā. Apskatīsim, kā izskatās valūtas moduļa izlaide:
currency: Object{}
code: "CAD"
name: "Canadian Dollar"
plural: "Canadian dollars"
symbol: "CA$"
symbol_native: "$"Drošības modulis
Droši vien nav tik populārs vai noderīgs kā iepriekšējaismoduļiem, drošības modulis joprojām ir interesants. Tas atgriež informāciju par vairākiem ienākošā savienojuma drošības aspektiem. Piemēram, tas jums pateiks, vai vietnei piekļūst, izmantojot starpniekserveri, un, ja jā, starpniekservera veidu vai arī pieprasījums ir ienācis caur tor tīkla. Tas var arī pateikt, ka pieprasījums ir no rāpuļprogrammas, nevis no faktiskā lietotāja. Šāda veida informāciju var izmantot, lai novērstu nokasīšanu. Modulis arī atgriež draudu līmeni, kas saistīts ar sniegto IP adresi, potenciāli ļaujot nodrošināt neapstrādātu aizsardzību pret ļaunprātīgiem pieprasījumiem. Šeit ir apskatīta tipiskā drošības moduļa atbilde:
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: nullLaika joslas modulis
Vēl viens modulis, kas var noderētpersonalizējiet savas vietnes apmeklētāju pieredzi, kas ir laika joslas modulis. Tas atgriež papildu informāciju par jūsu vietnes apmeklētājiem - jūs to uzminējāt. Viena no vietām, kur jūs varētu izmantot šādu funkciju vietnēs, kas nodarbojas ar laika ziņā sensitīvu informāciju. Tas ļauj jums parādīt pareizo laiku, pamatojoties uz jūsu lietotāja atrašanās vietu.
Modulis nodrošina tādu informāciju kā GMT nobīde, pašreizējais lietotāja laiks, laika kods un laika joslas atrašanās vieta, kā jūs varat redzēt no šīs atbildes parauga:
time_zone: Object{}
id: "America/Montreal"
current_time: "2019-07-09T12:39:22-04:00"
gmt_offset: -14400
code: "EDT"
is_daylight_saving: trueSavienojuma modulis
Pēdējais, bet ne mazāk svarīgais ir savienojuma modulis. Šis ir diezgan vienkāršots. Atgriežas tikai autonomās sistēmas (AS) numurs, kas saistīts ar avota IP adresi, kā arī ISP nosaukums. Tas patiesībā ir drīzāk AS īpašnieka vārds, nevis ISP. Dažas organizācijas reģistrē savu autonomu sistēmu, kā tas ir šajā piemērā:
connection: Object{}
asn: 395399
isp: "City of Montreal"Tas, iespējams, ir vismazāk noderīgais no visiem moduļiem, bet daži to uzskatīs par noderīgu dažādiem analītiskiem mērķiem.
Darbs ar ipstack API
Mēs esam apskatījuši, kāda informācija var būtatgriezta ar ipstack API, tagad ir pienācis laiks apskatīt, kā to sauc. Ipstack API piedāvā trīs dažādu veidu vaicājumus, katrs ar atšķirīgiem parametriem. Ir standarta meklēšana, lielapjoma meklēšana un pieprasījuma iesniedzēja meklēšana. Let 's redzēt, kā viņi atšķiras Šī ir jauka īpašība, jo, piemēram, lielapjoma pieprasījums ļauj apvienot vairākus pieprasījumus vienā, tādējādi samazinot kopējo pieskaitāmās izmaksas un ļaujot sasniegt ātrākus rezultātus. Apskatīsim padziļināti katru pieprasījuma veidu.
Standarta meklēšana
Kā jūs jau varējāt uzminēt, standarta meklēšana irvisvienkāršākais. Tas atgriež informāciju par atsevišķu IP adresi, kuru sniedzat, piezvanot uz ipstack API. Tas ir diezgan vienkārši lietojams, un tas darbosies gan ar IPv4, gan ar IPv6 adresēm. Lai padarītu lietu vēl vieglāku, produkta dokumentācijā ir standarta pieprasījuma parauga kods gan PHP (cURL), gan JavaScript (Jquery.ajax). Ja jūsu vietne tiek veidota, izmantojot kādu no šīm, tad API lietošana tiešām nav prāta. Šis ir tipiska API zvana piemērs, izmantojot vienkāršu HTML kodu:
https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY
Šajā piemērā YOUR_ACCESS_KEY tiktu aizstāts ar faktisko piekļuves atslēgusaņēmāt, kad pierakstījāties uz pakalpojumu. Šajā piemērā jūs norādītu arī faktisko IP adresi, par kuru vēlaties iegūt informāciju, nevis fiktīvu.
Standarta uzmeklēšanas rezultāti ietver visusmoduļi pēc noklusējuma, bet papildu parametri ļauj jums pielāgot pieprasījumu atbilstoši jūsu precīzajām vajadzībām. Visa informācija par pieejamajiem parametriem ir skaidri izskaidrota izstrādājuma dokumentācijā. Tāpat noklusējuma atbilde ir JSON objekts, bet parametri to var mainīt uz XML formātu.
Lielapjoma un pieprasījuma iesniedzēju meklēšana
Lielapjoma uzmeklēšana ļauj pieprasīt datus pretvairākas IP adreses vienā pieprasījumā. Tāpat kā standarta meklēšanu, jūs varat iegūt datus gan par IPv4, gan IPv6 adresēm. Vienā pieprasījumā varat pat sajaukt abu veidu adreses. Pieprasījuma formāts ir tāds pats kā standarta meklēšanā, izņemot to, ka jūs norādāt vairākas IP adreses, atdalītas ar komatiem.
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
Pēdējais pieprasījuma tips, ko piedāvā ipstackAPI ir pieprasījuma iesniedzējs. Tas atgriezīs informāciju par IP adresi, no kuras nāk pieprasījums. Tas ir pieprasījuma veids, kuru izpildāt, izsniedzot klienta puses skriptu. Lai veiktu pieprasījuma pieprasītāju, IP adreses vietā izmantojiet tikai atslēgvārdu “pārbaude”. Pārējie pieejamie pieprasījuma parametri ir tādi paši kā citiem pieprasījuma veidiem.
https://api.ipstack.com/check?access_key=YOUR_ACCESS_KEY
Kā darbojas ipstack API?
Ipstack API ir kaut kas vairāk nekā iespējamsjūs integrējāties reālā laika vietnē. Piemēram, iespējams, vēlēsities apkalpot atšķirīgu saturu, pamatojoties uz klienta atrašanās vietu. Lai to paveiktu, jums ir nepieciešama API, kas darbosies ļoti ātri. Jebkāda kavēšanās API atbildē nozīmē, ka lapas parādīšana klientam tiek aizkavēta - tas ir tas, no kura jūs, visticamāk, vēlaties izvairīties. Tas pats ir spēkā neatkarīgi no tā, kādam mērķim izmantojat atrašanās vietas datus. Tāpēc izmantotā rīka reakcijas laiks ir ārkārtīgi svarīgs. Kaut arī ģeogrāfiskās atrašanās vietas noteikšanas API var nodrošināt tik nepieciešamo funkcionalitāti, tās neveikšanai var būt postoša ietekme.
Šo iemeslu dēļ jums jāizvēlas API arlabs reakcijas laiks. Mēs esam paveikuši daudz smaga darba, pārbaudot dažādus scenārijus un veicot testus ar vienu vai vairākām IP adresēm, dažās ar vairāk izvēles parametriem, citās ar mazākām. Mēs bijām diezgan apmierināti ar rezultātiem un saņēmām diezgan konsekventu atbildes laiku - apmēram 100 ms, neatkarīgi no pieprasījuma. Laika gaitā arī reakcija bija konsekventa, bez acīmredzamām “sastrēgumstundām”, kad varētu ciest sniegums, un tā bija līdzīga arī neatkarīgi no tā, kur mēs iesniedzām pieprasījumus. Liekas, ka ipstack serveri ir veidoti, lai apstrādātu saņemto slodzi. Kopumā šķiet, ka ipstack API izmantošana gandrīz neietekmēja vietnes reakciju no lietotāja viedokļa.
Produktu dokumentācija un atbalsts
Bieži tiek teikts, ka produkts ir tikai tik labskā tās dokumentācija. Ja tā ir taisnība, ipstack API nav ko baidīties, jo tās dokumentāciju ir viegli atrast, lietot un saprast. Dokumentācijas kvalitāte arī parāda, cik daudz programmatūras izdevējs rūpējas par saviem lietotājiem. Šeit atkal nav par ko uztraukties.
Viena no labākajām lietām par šo produktudīvainā kārtā dokumentācija ir tāda, cik maz ir. Viss ietilpst vienā labi izveidotā tīmekļa lapā, kur viegli atradīsit visu nepieciešamo. Un, lai to padarītu vēl vienkāršāku, izvēlnes rūts ļauj piekļūt jebkurai sadaļai. Dokumentācija aptver visu, sākot no dažāda veida pieprasījumu izmantošanas līdz atbildes pielāgošanai.
Ļoti maz ticams gadījumā, ja jūs to nedarītuatrodiet nepieciešamo dokumentācijā, ir pieejams arī atbalsts. Sākotnēji tehniskā atbalsta sasniegšana var aizņemt kādu laiku, bet, tiklīdz jūs to darāt, viņi reaģē diezgan ātri.
Cenu noteikšana
Ir pieejami vairāki cenu plāniipstack API. Zemākajā līmenī ir bezmaksas plāns. Kā norāda nosaukums, šī ir bezmaksas. Tas ir arī nedaudz ierobežots. Iesācējiem mēnesī varat veikt tikai līdz 10 000 vaicājumu. Tajā ir arī tikai atrašanās vietas modulis, un piekļuve atbalstam ir ierobežota. Tas tomēr var būt lielisks veids, kā pārbaudīt produktu un redzēt, kā tas var integrēties jūsu vidē.
Nākamais līmenis ir pamatplāns. Šis tiek pārdots par USD 9,99 mēnesī vai par USD 95,90 gadā (20% atlaide) un palielina pieprasījumu ierobežojumu līdz 50 000 mēnesī. Tas arī ļauj izmantot moduļus Valūta, Laika josla un Savienojums. Plānā ir iekļauts arī uzlabots atbalsts, kā arī uzlabota drošība, izmantojot SSL šifrēšanu.
Populārākais plāns ir profesionālaiskas pārdod par USD 49,99 mēnesī vai USD 479,90 gadā. Tas dod jums visu, kas ir iekļauts pamatplānā, bet palielina ikmēneša pieprasījumu skaitu līdz 500 000 un ietver arī iespēju veikt lielapjoma pieprasījumus.
Augšpusē ir profesionālais plus plāns. Tas maksā USD 99,99 mēnesī vai 959,90 USD gadā. Tas ir identisks profesionālajam plānam, bet tas pieļauj līdz 2 miljoniem pieprasījumu mēnesī, un tas ir vienīgais plāns, kurā iekļauts drošības modulis.
Ja ar to nepietiek, ir arīpielāgojams uzņēmuma plāns, kuru var sakārtot, sazinoties ar ipstack. Tajā var ietilpt tik daudz mēneša pieprasījumu, cik jums varētu būt nepieciešams, kā arī dažādi pielāgoti risinājumi, pamatojoties uz klienta īpašajām vajadzībām.
Noslēgumā
Ipstack API ir lielisks produkts, kas būsļaujiet ātri un ērti iegūt tik daudz datu, ko varat iegūt no IP adreses. Tam ir pārsteidzošs reakcijas laiks, lieliska dokumentācija un labs atbalsts, kas apvieno to padarot par lielisku naudas vērtību. Arī tas, ka to izmanto vairāki interneta giganti, iespējams, ir labs produkta vērtības apliecinājums.
Tas noteikti ir produkts, kuru es ieteiktu, jajūs meklējat datu izmantošanu, ko var apkopot jūsu vietnes apmeklētāja IP adresei. Un, tā kā ir pieejams bezmaksas - kaut arī ierobežots - plāns, nav iemesla, kāpēc jums nevajadzētu to vismaz izmēģināt, pārliecināties par to, ko tas var jūsu labā izdarīt.
Komentāri