ip2location_io_ruby 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile +1 -0
- data/LICENSE.txt +21 -21
- data/README.md +22 -367
- data/example.rb +9 -1
- data/ip2location_io_ruby.gemspec +11 -0
- data/lib/ip2location_io_ruby/api/hosteddomain.rb +31 -0
- data/lib/ip2location_io_ruby/version.rb +1 -1
- data/lib/ip2location_io_ruby.rb +1 -0
- data/spec/ip2location_io_ruby_domainwhois_spec.rb +3 -3
- data/spec/ip2location_io_ruby_hosteddomain_spec.rb +45 -0
- data/spec/ip2location_io_ruby_ipgeolocation_spec.rb +2 -2
- metadata +25 -8
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: e28d60000d9d54118d8ef7b325d9edd1bfd7995755587a551c0195e66705bb1e
|
|
4
|
+
data.tar.gz: 64bc99214843ec4ce09a899ccdec25bfe5c9fffcb73996e0f58d86dad6b2b012
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: '099a6263fdf55ec3bb463820a139e394140373cc6bde9caa687be4053293ebc19f908d60a8ec3c3be73e887abef6ca743d485d88cdb2f1ce0595521bd899692a'
|
|
7
|
+
data.tar.gz: 2f4844aae8588f1ab2c526b770b4488c8dca491be597bf2b1207a7dd5b343b562beb582a86da13219eb1be6680b4d9d5c3998f4a706d0d2a9136ab3d2ad82f18
|
data/Gemfile
CHANGED
data/LICENSE.txt
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c)
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 IP2Location.com
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
data/README.md
CHANGED
|
@@ -1,367 +1,22 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
### Lookup Domain Information
|
|
24
|
-
```ruby
|
|
25
|
-
require 'ip2location_io_ruby'
|
|
26
|
-
|
|
27
|
-
# Configures IP2Location.io API key
|
|
28
|
-
IP2LocationIORuby::Configuration.api_key = 'YOUR_API_KEY'
|
|
29
|
-
|
|
30
|
-
# Lookup domain information
|
|
31
|
-
IP2LocationIORuby::Api::DomainWhois.lookup('example.com');
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
### Convert Normal Text to Punycode
|
|
35
|
-
```ruby
|
|
36
|
-
require 'ip2location_io_ruby'
|
|
37
|
-
|
|
38
|
-
# Configures IP2Location.io API key
|
|
39
|
-
IP2LocationIORuby::Configuration.api_key = 'YOUR_API_KEY'
|
|
40
|
-
|
|
41
|
-
# Convert normal text to punycode
|
|
42
|
-
IP2LocationIORuby::Api::DomainWhois.get_punycode('täst.de');
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
### Convert Punycode to Normal Text
|
|
46
|
-
```ruby
|
|
47
|
-
require 'ip2location_io_ruby'
|
|
48
|
-
|
|
49
|
-
# Configures IP2Location.io API key
|
|
50
|
-
IP2LocationIORuby::Configuration.api_key = 'YOUR_API_KEY'
|
|
51
|
-
|
|
52
|
-
# Convert punycode to normal text
|
|
53
|
-
IP2LocationIORuby::Api::DomainWhois.get_normal_text('xn--tst-qla.de');
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Get Domain Name
|
|
57
|
-
```ruby
|
|
58
|
-
require 'ip2location_io_ruby'
|
|
59
|
-
|
|
60
|
-
# Configures IP2Location.io API key
|
|
61
|
-
IP2LocationIORuby::Configuration.api_key = 'YOUR_API_KEY'
|
|
62
|
-
|
|
63
|
-
# Get domain name from URL
|
|
64
|
-
IP2LocationIORuby::Api::DomainWhois.get_domain_name('https://www.example.com/exe');
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### Get Domain Extension
|
|
68
|
-
```ruby
|
|
69
|
-
require 'ip2location_io_ruby'
|
|
70
|
-
|
|
71
|
-
# Configures IP2Location.io API key
|
|
72
|
-
IP2LocationIORuby::Configuration.api_key = 'YOUR_API_KEY'
|
|
73
|
-
|
|
74
|
-
# Get domain extension (gTLD or ccTLD) from URL or domain name
|
|
75
|
-
IP2LocationIORuby::Api::DomainWhois.get_domain_extension('example.com');
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
Response Parameter
|
|
80
|
-
============
|
|
81
|
-
### IP Geolocation Lookup function
|
|
82
|
-
| Parameter | Type | Description |
|
|
83
|
-
|---|---|---|
|
|
84
|
-
|ip|string|IP address.|
|
|
85
|
-
|country_code|string|Two-character country code based on ISO 3166.|
|
|
86
|
-
|country_name|string|Country name based on ISO 3166.|
|
|
87
|
-
|region_name|string|Region or state name.|
|
|
88
|
-
|city_name|string|City name.|
|
|
89
|
-
|latitude|double|City latitude. Defaults to capital city latitude if city is unknown.|
|
|
90
|
-
|longitude|double|City longitude. Defaults to capital city longitude if city is unknown.|
|
|
91
|
-
|zip_code|string|ZIP/Postal code.|
|
|
92
|
-
|time_zone|string|UTC time zone (with DST supported).|
|
|
93
|
-
|asn|string|Autonomous system number (ASN).|
|
|
94
|
-
|as|string|Autonomous system (AS) name.|
|
|
95
|
-
|isp|string|Internet Service Provider or company's name.|
|
|
96
|
-
|domain|string|Internet domain name associated with IP address range.|
|
|
97
|
-
|net_speed|string|Internet connection type. DIAL = dial-up, DSL = broadband/cable/fiber/mobile, COMP = company/T1|
|
|
98
|
-
|idd_code|string|The IDD prefix to call the city from another country.|
|
|
99
|
-
|area_code|string|A varying length number assigned to geographic areas for calls between cities.|
|
|
100
|
-
|weather_station_code|string|The special code to identify the nearest weather observation station.|
|
|
101
|
-
|weather_station_name|string|The name of the nearest weather observation station.|
|
|
102
|
-
|mcc|string|Mobile Country Codes (MCC) as defined in ITU E.212 for use in identifying mobile stations in wireless telephone networks, particularly GSM and UMTS networks.|
|
|
103
|
-
|mnc|string|Mobile Network Code (MNC) is used in combination with a Mobile Country Code (MCC) to uniquely identify a mobile phone operator or carrier.|
|
|
104
|
-
|mobile_brand|string|Commercial brand associated with the mobile carrier.|
|
|
105
|
-
|elevation|integer|Average height of city above sea level in meters (m).|
|
|
106
|
-
|usage_type|string|Usage type classification of ISP or company.|
|
|
107
|
-
|address_type|string|IP address types as defined in Internet Protocol version 4 (IPv4) and Internet Protocol version 6 (IPv6).|
|
|
108
|
-
|continent.name|string|Continent name.|
|
|
109
|
-
|continent.code|string|Two-character continent code.|
|
|
110
|
-
|continent.hemisphere|array|The hemisphere of where the country located. The data in array format with first item indicates (north/south) hemisphere and second item indicates (east/west) hemisphere information.|
|
|
111
|
-
|continent.translation|object|Translation data based on the given lang code.|
|
|
112
|
-
|country.name|string|Country name based on ISO 3166.|
|
|
113
|
-
|country.alpha3_code|string|Three-character country code based on ISO 3166.|
|
|
114
|
-
|country.numeric_code|string|Three-character country numeric code based on ISO 3166.|
|
|
115
|
-
|country.demonym|string|Native of the country.|
|
|
116
|
-
|country.flag|string|URL of the country flag image.|
|
|
117
|
-
|country.capital|string|Capital of the country.|
|
|
118
|
-
|country.total_area|integer|Total area in km2.|
|
|
119
|
-
|country.population|integer|Population of the country.|
|
|
120
|
-
|country.currency|object|Currency of the country.|
|
|
121
|
-
|country.language|object|Language of the country.|
|
|
122
|
-
|country.tld|string|Country-Code Top-Level Domain.|
|
|
123
|
-
|country.translation|object|Translation data based on the given lang code.|
|
|
124
|
-
|region.name|string|Region or state name.|
|
|
125
|
-
|region.code|string|ISO3166-2 code.|
|
|
126
|
-
|region.translation|object|Translation data based on the given lang code.|
|
|
127
|
-
|city.name|string| City name.|
|
|
128
|
-
|city.translation|object|Translation data based on the given lang code.|
|
|
129
|
-
|time_zone_info.olson|string|Time zone in Olson format.|
|
|
130
|
-
|time_zone_info.current_time|string|Current time in ISO 8601 format.|
|
|
131
|
-
|time_zone_info.gmt_offset|integer|GMT offset value in seconds.|
|
|
132
|
-
|time_zone_info.is_dst|boolean|Indicate if the time zone value is in DST.|
|
|
133
|
-
|time_zone_info.sunrise|string|Time of sunrise. (hh:mm format in local time, i.e, 07:47)|
|
|
134
|
-
|time_zone_info.sunset|string|Time of sunset. (hh:mm format in local time, i.e 19:50)|
|
|
135
|
-
|geotargeting.metro|string|Metro code based on zip/postal code.|
|
|
136
|
-
|ads_category|string|The domain category code based on IAB Tech Lab Content Taxonomy.|
|
|
137
|
-
|ads_category_name|string|The domain category based on IAB Tech Lab Content Taxonomy. These categories are comprised of Tier-1 and Tier-2 (if available) level categories widely used in services like advertising, Internet security and filtering appliances.|
|
|
138
|
-
|is_proxy|boolean|Whether is a proxy or not.|
|
|
139
|
-
|proxy.last_seen|integer|Proxy last seen in days.|
|
|
140
|
-
|proxy.proxy_type|string|Type of proxy.|
|
|
141
|
-
|proxy.threat|string|Security threat reported.|
|
|
142
|
-
|proxy.provider|string|Name of VPN provider if available.|
|
|
143
|
-
|
|
144
|
-
```json
|
|
145
|
-
{
|
|
146
|
-
"ip":"8.8.8.8",
|
|
147
|
-
"country_code":"US",
|
|
148
|
-
"country_name":"United States of America",
|
|
149
|
-
"region_name":"California",
|
|
150
|
-
"city_name":"Mountain View",
|
|
151
|
-
"latitude":37.405992,
|
|
152
|
-
"longitude":-122.078515,
|
|
153
|
-
"zip_code":"94043",
|
|
154
|
-
"time_zone":"-07:00",
|
|
155
|
-
"asn":"15169",
|
|
156
|
-
"as":"Google LLC",
|
|
157
|
-
"isp":"Google LLC",
|
|
158
|
-
"domain":"google.com",
|
|
159
|
-
"net_speed":"T1",
|
|
160
|
-
"idd_code":"1",
|
|
161
|
-
"area_code":"650",
|
|
162
|
-
"weather_station_code":"USCA0746",
|
|
163
|
-
"weather_station_name":"Mountain View",
|
|
164
|
-
"mcc":"-",
|
|
165
|
-
"mnc":"-",
|
|
166
|
-
"mobile_brand":"-",
|
|
167
|
-
"elevation":32,
|
|
168
|
-
"usage_type":"DCH",
|
|
169
|
-
"address_type":"Anycast",
|
|
170
|
-
"continent":{
|
|
171
|
-
"name":"North America",
|
|
172
|
-
"code":"NA",
|
|
173
|
-
"hemisphere":["north","west"],
|
|
174
|
-
"translation":{
|
|
175
|
-
"lang":"ko",
|
|
176
|
-
"value":"북아메리카"
|
|
177
|
-
}
|
|
178
|
-
},
|
|
179
|
-
"country":{
|
|
180
|
-
"name":"United States of America",
|
|
181
|
-
"alpha3_code":"USA",
|
|
182
|
-
"numeric_code":840,
|
|
183
|
-
"demonym":"Americans",
|
|
184
|
-
"flag":"https://cdn.ip2location.io/assets/img/flags/us.png",
|
|
185
|
-
"capital":"Washington, D.C.",
|
|
186
|
-
"total_area":9826675,
|
|
187
|
-
"population":331002651,
|
|
188
|
-
"currency":{
|
|
189
|
-
"code":"USD",
|
|
190
|
-
"name":"United States Dollar",
|
|
191
|
-
"symbol":"$"
|
|
192
|
-
},
|
|
193
|
-
"language":{
|
|
194
|
-
"code":"EN",
|
|
195
|
-
"name":"English"
|
|
196
|
-
},
|
|
197
|
-
"tld":"us",
|
|
198
|
-
"translation":{
|
|
199
|
-
"lang":"ko",
|
|
200
|
-
"value":"미국"
|
|
201
|
-
}
|
|
202
|
-
},
|
|
203
|
-
"region":{
|
|
204
|
-
"name":"California",
|
|
205
|
-
"code":"US-CA",
|
|
206
|
-
"translation":{
|
|
207
|
-
"lang":"ko",
|
|
208
|
-
"value":"캘리포니아주"
|
|
209
|
-
}
|
|
210
|
-
},
|
|
211
|
-
"city":{
|
|
212
|
-
"name":"Mountain View",
|
|
213
|
-
"translation":{
|
|
214
|
-
"lang":null,
|
|
215
|
-
"value":null
|
|
216
|
-
}
|
|
217
|
-
},
|
|
218
|
-
"time_zone_info":{
|
|
219
|
-
"olson":"America/Los_Angeles",
|
|
220
|
-
"current_time":"2022-04-18T23:41:57-07:00",
|
|
221
|
-
"gmt_offset":-25200,
|
|
222
|
-
"is_dst":true,
|
|
223
|
-
"sunrise":"06:27",
|
|
224
|
-
"sunset":"19:47"
|
|
225
|
-
},
|
|
226
|
-
"geotargeting":{
|
|
227
|
-
"metro":"807"
|
|
228
|
-
},
|
|
229
|
-
"ads_category":"IAB19",
|
|
230
|
-
"ads_category_name":"Technology & Computing",
|
|
231
|
-
"is_proxy":false,
|
|
232
|
-
"proxy":{
|
|
233
|
-
"last_seen":18,
|
|
234
|
-
"proxy_type":"DCH",
|
|
235
|
-
"threat":"-",
|
|
236
|
-
"provider":"-"
|
|
237
|
-
}
|
|
238
|
-
}
|
|
239
|
-
```
|
|
240
|
-
|
|
241
|
-
### Domain WHOIS Lookup function
|
|
242
|
-
| Parameter | Type | Description |
|
|
243
|
-
|---|---|---|
|
|
244
|
-
|domain|string|Domain name.|
|
|
245
|
-
|domain_id|string|Domain name ID.|
|
|
246
|
-
|status|string|Domain name status.|
|
|
247
|
-
|create_date|string|Domain name creation date.|
|
|
248
|
-
|update_date|string|Domain name updated date.|
|
|
249
|
-
|expire_date|string|Domain name expiration date.|
|
|
250
|
-
|domain_age|integer|Domain name age in day(s).|
|
|
251
|
-
|whois_server|string|WHOIS server name.|
|
|
252
|
-
|registrar.iana_id|string|Registrar IANA ID.|
|
|
253
|
-
|registrar.name|string|Registrar name.|
|
|
254
|
-
|registrar.url|string|Registrar URL.|
|
|
255
|
-
|registrant.name|string|Registrant name.|
|
|
256
|
-
|registrant.organization|string|Registrant organization.|
|
|
257
|
-
|registrant.street_address|string|Registrant street address.|
|
|
258
|
-
|registrant.city|string|Registrant city.|
|
|
259
|
-
|registrant.region|string|Registrant region.|
|
|
260
|
-
|registrant.zip_code|string|Registrant ZIP Code.|
|
|
261
|
-
|registrant.country|string|Registrant country.|
|
|
262
|
-
|registrant.phone|string|Registrant phone number.|
|
|
263
|
-
|registrant.fax|string|Registrant fax number.|
|
|
264
|
-
|registrant.email|string|Registrant email address.|
|
|
265
|
-
|admin.name|string|Admin name.|
|
|
266
|
-
|admin.organization|string|Admin organization.|
|
|
267
|
-
|admin.street_address|string|Admin street address.|
|
|
268
|
-
|admin.city|string|Admin city.|
|
|
269
|
-
|admin.region|string|Admin region.|
|
|
270
|
-
|admin.zip_code|string|Admin ZIP Code.|
|
|
271
|
-
|admin.country|string|Admin country.|
|
|
272
|
-
|admin.phone|string|Admin phone number.|
|
|
273
|
-
|admin.fax|string|Admin fax number.|
|
|
274
|
-
|admin.email|string|Admin email address.|
|
|
275
|
-
|tech.name|string|Tech name.|
|
|
276
|
-
|tech.organization|string|Tech organization.|
|
|
277
|
-
|tech.street_address|string|Tech street address.|
|
|
278
|
-
|tech.city|string|Tech city.|
|
|
279
|
-
|tech.region|string|Tech region.|
|
|
280
|
-
|tech.zip_code|string|Tech ZIP Code.|
|
|
281
|
-
|tech.country|string|Tech country.|
|
|
282
|
-
|tech.phone|string|Tech phone number.|
|
|
283
|
-
|tech.fax|string|Tech fax number.|
|
|
284
|
-
|tech.email|string|Tech email address.|
|
|
285
|
-
|billing.name|string|Billing name.|
|
|
286
|
-
|billing.organization|string|Billing organization.|
|
|
287
|
-
|billing.street_address|string|Billing street address.|
|
|
288
|
-
|billing.city|string|Billing city.|
|
|
289
|
-
|billing.region|string|Billing region.|
|
|
290
|
-
|billing.zip_code|string|Billing ZIP Code.|
|
|
291
|
-
|billing.country|string|Billing country.|
|
|
292
|
-
|billing.phone|string|Billing phone number.|
|
|
293
|
-
|billing.fax|string|Billing fax number.|
|
|
294
|
-
|billing.email|string|Billing email address.|
|
|
295
|
-
|name_servers|array|Name servers|
|
|
296
|
-
|
|
297
|
-
```json
|
|
298
|
-
{
|
|
299
|
-
"domain": "locaproxy.com",
|
|
300
|
-
"domain_id": "1710914405_DOMAIN_COM-VRSN",
|
|
301
|
-
"status": "clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
|
|
302
|
-
"create_date": "2012-04-03T02:34:32Z",
|
|
303
|
-
"update_date": "2021-12-03T02:54:57Z",
|
|
304
|
-
"expire_date": "2024-04-03T02:34:32Z",
|
|
305
|
-
"domain_age": 3863,
|
|
306
|
-
"whois_server": "whois.godaddy.com",
|
|
307
|
-
"registrar": {
|
|
308
|
-
"iana_id": "146",
|
|
309
|
-
"name": "GoDaddy.com, LLC",
|
|
310
|
-
"url": "https://www.godaddy.com"
|
|
311
|
-
},
|
|
312
|
-
"registrant": {
|
|
313
|
-
"name": "Registration Private",
|
|
314
|
-
"organization": "Domains By Proxy, LLC",
|
|
315
|
-
"street_address": "DomainsByProxy.com",
|
|
316
|
-
"city": "Tempe",
|
|
317
|
-
"region": "Arizona",
|
|
318
|
-
"zip_code": "85284",
|
|
319
|
-
"country": "US",
|
|
320
|
-
"phone": "+1.4806242599",
|
|
321
|
-
"fax": "+1.4806242598",
|
|
322
|
-
"email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
|
|
323
|
-
},
|
|
324
|
-
"admin": {
|
|
325
|
-
"name": "Registration Private",
|
|
326
|
-
"organization": "Domains By Proxy, LLC",
|
|
327
|
-
"street_address": "DomainsByProxy.com",
|
|
328
|
-
"city": "Tempe",
|
|
329
|
-
"region": "Arizona",
|
|
330
|
-
"zip_code": "85284",
|
|
331
|
-
"country": "US",
|
|
332
|
-
"phone": "+1.4806242599",
|
|
333
|
-
"fax": "+1.4806242598",
|
|
334
|
-
"email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
|
|
335
|
-
},
|
|
336
|
-
"tech": {
|
|
337
|
-
"name": "Registration Private",
|
|
338
|
-
"organization": "Domains By Proxy, LLC",
|
|
339
|
-
"street_address": "DomainsByProxy.com",
|
|
340
|
-
"city": "Tempe",
|
|
341
|
-
"region": "Arizona",
|
|
342
|
-
"zip_code": "85284",
|
|
343
|
-
"country": "US",
|
|
344
|
-
"phone": "+1.4806242599",
|
|
345
|
-
"fax": "+1.4806242598",
|
|
346
|
-
"email": "Select Contact Domain Holder link at https://www.godaddy.com/whois/results.aspx?domain=LOCAPROXY.COM"
|
|
347
|
-
},
|
|
348
|
-
"billing": {
|
|
349
|
-
"name": "",
|
|
350
|
-
"organization": "",
|
|
351
|
-
"street_address": "",
|
|
352
|
-
"city": "",
|
|
353
|
-
"region": "",
|
|
354
|
-
"zip_code": "",
|
|
355
|
-
"country": "",
|
|
356
|
-
"phone": "",
|
|
357
|
-
"fax": "",
|
|
358
|
-
"email": ""
|
|
359
|
-
},
|
|
360
|
-
"nameservers": "vera.ns.cloudflare.com, walt.ns.cloudflare.com"
|
|
361
|
-
}
|
|
362
|
-
```
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
LICENCE
|
|
366
|
-
=====================
|
|
367
|
-
See the LICENSE file.
|
|
1
|
+
[](https://rubygems.org/gems/ip2location_io_ruby)
|
|
2
|
+
[](https://rubygems.org/gems/ip2location_io_ruby)
|
|
3
|
+
|
|
4
|
+
IP2Location.io Ruby SDK
|
|
5
|
+
========================
|
|
6
|
+
This Ruby module enables user to query for an enriched data set, such as country, region, district, city, latitude & longitude, ZIP code, time zone, ASN, ISP, domain, net speed, IDD code, area code, weather station data, MNC, MCC, mobile brand, elevation, usage type, address type, advertisement category and proxy data with an IP address. It supports both IPv4 and IPv6 address lookup.
|
|
7
|
+
|
|
8
|
+
In addition, this module provides WHOIS lookup API that helps users to obtain domain information, WHOIS record, by using a domain name. The WHOIS API returns a comprehensive WHOIS data such as creation date, updated date, expiration date, domain age, the contact information of the registrant, mailing address, phone number, email address, nameservers the domain is using and much more.
|
|
9
|
+
|
|
10
|
+
There is also a Hosted Domain API that allowing users to get the list of hosted domain names by IP address in real time. The REST API supports both IPv4 and IPv6 address lookup.
|
|
11
|
+
|
|
12
|
+
This module requires API key to function. You may sign up for a free API key at https://www.ip2location.io/pricing.
|
|
13
|
+
|
|
14
|
+
Developer Documentation
|
|
15
|
+
=====================
|
|
16
|
+
|
|
17
|
+
To learn more about installation, usage, and code examples, please visit the developer documentation at [https://ip2location-io-ruby.readthedocs.io/en/latest/index.html](https://ip2location-io-ruby.readthedocs.io/en/latest/index.html).
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
LICENCE
|
|
21
|
+
=====================
|
|
22
|
+
See the LICENSE file.
|
data/example.rb
CHANGED
|
@@ -20,4 +20,12 @@ end
|
|
|
20
20
|
puts IP2LocationIORuby::Api::DomainWhois.get_punycode('täst.de')
|
|
21
21
|
puts IP2LocationIORuby::Api::DomainWhois.get_normal_text('xn--tst-qla.de')
|
|
22
22
|
puts IP2LocationIORuby::Api::DomainWhois.get_domain_name('https://www.example.com/exe')
|
|
23
|
-
puts IP2LocationIORuby::Api::DomainWhois.get_domain_extension('example.com')
|
|
23
|
+
puts IP2LocationIORuby::Api::DomainWhois.get_domain_extension('example.com')
|
|
24
|
+
|
|
25
|
+
begin
|
|
26
|
+
result = IP2LocationIORuby::Api::HostedDomain.lookup('8.8.8.8')
|
|
27
|
+
rescue Exception => e
|
|
28
|
+
puts e.message
|
|
29
|
+
else
|
|
30
|
+
puts result.body
|
|
31
|
+
end
|
data/ip2location_io_ruby.gemspec
CHANGED
|
@@ -29,11 +29,22 @@ Gem::Specification.new do |s|
|
|
|
29
29
|
"lib/ip2location_io_ruby.rb",
|
|
30
30
|
"lib/ip2location_io_ruby/api.rb",
|
|
31
31
|
"lib/ip2location_io_ruby/api/domainwhois.rb",
|
|
32
|
+
"lib/ip2location_io_ruby/api/hosteddomain.rb",
|
|
32
33
|
"lib/ip2location_io_ruby/api/ipgeolocation.rb",
|
|
33
34
|
"lib/ip2location_io_ruby/configuration.rb",
|
|
34
35
|
"lib/ip2location_io_ruby/version.rb",
|
|
35
36
|
"spec/spec_helper.rb",
|
|
36
37
|
"spec/ip2location_io_ruby_domainwhois_spec.rb",
|
|
38
|
+
"spec/ip2location_io_ruby_hosteddomain_spec.rb",
|
|
37
39
|
"spec/ip2location_io_ruby_ipgeolocation_spec.rb"
|
|
38
40
|
]
|
|
41
|
+
if s.respond_to?(:metadata=)
|
|
42
|
+
s.metadata = {
|
|
43
|
+
"bug_tracker_uri" => "https://github.com/ip2location/ip2location-io-ruby/issues",
|
|
44
|
+
"documentation_uri" => "https://www.rubydoc.info/gems/ip2location_io_ruby",
|
|
45
|
+
"homepage_uri" => "https://www.ip2location.io",
|
|
46
|
+
"source_code_uri" => "https://github.com/ip2location/ip2location-io-ruby",
|
|
47
|
+
}
|
|
48
|
+
end
|
|
49
|
+
s.add_runtime_dependency "simpleidn", "~> 0.2"
|
|
39
50
|
end
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
require 'uri'
|
|
2
|
+
require 'json'
|
|
3
|
+
require 'net/http'
|
|
4
|
+
require "ip2location_io_ruby/configuration"
|
|
5
|
+
require "ip2location_io_ruby/version"
|
|
6
|
+
|
|
7
|
+
module IP2LocationIORuby
|
|
8
|
+
module Api
|
|
9
|
+
class HostedDomain
|
|
10
|
+
|
|
11
|
+
# Lookup hosted domains information.
|
|
12
|
+
def self.lookup(ip, page = 1)
|
|
13
|
+
uri = URI.parse("https://domains.ip2whois.com/domains?key=" + IP2LocationIORuby::Configuration.api_key + "&format=json&ip=" + ip + "&page=" + page.to_s + "source=sdk-ruby-iplio&source_version=" + IP2LocationIORuby::VERSION)
|
|
14
|
+
http = Net::HTTP.new(uri.host, uri.port)
|
|
15
|
+
http.use_ssl = true
|
|
16
|
+
request = Net::HTTP::Get.new(uri.request_uri)
|
|
17
|
+
|
|
18
|
+
response = http.request(request)
|
|
19
|
+
|
|
20
|
+
if response == nil
|
|
21
|
+
raise Exception.new "HostedDomain lookup error."
|
|
22
|
+
elsif JSON[response.body]['error']
|
|
23
|
+
raise Exception.new JSON[response.body]['error']['error_message']
|
|
24
|
+
else
|
|
25
|
+
return response
|
|
26
|
+
end
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
end
|
|
30
|
+
end
|
|
31
|
+
end
|
data/lib/ip2location_io_ruby.rb
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
require "ip2location_io_ruby/api"
|
|
2
2
|
require "ip2location_io_ruby/api/ipgeolocation"
|
|
3
3
|
require "ip2location_io_ruby/api/domainwhois"
|
|
4
|
+
require "ip2location_io_ruby/api/hosteddomain"
|
|
4
5
|
require "ip2location_io_ruby/configuration"
|
|
5
6
|
require "ip2location_io_ruby/version"
|
|
6
7
|
|
|
@@ -6,17 +6,17 @@ describe "IP2LocationIORuby" do
|
|
|
6
6
|
begin
|
|
7
7
|
IP2LocationIORuby::Api::DomainWhois.lookup('example.c')
|
|
8
8
|
rescue Exception => e
|
|
9
|
-
expect(e.message).to eq '
|
|
9
|
+
expect(e.message).to eq 'API key not found.'
|
|
10
10
|
end
|
|
11
11
|
end
|
|
12
12
|
|
|
13
13
|
it "work correctly with Api Key exist" do
|
|
14
14
|
if $test_api_key == 'YOUR_API_KEY'
|
|
15
15
|
print "/*
|
|
16
|
-
* You could enter a
|
|
16
|
+
* You could enter a IP2Location.io API Key in spec/spec_helper.rb
|
|
17
17
|
* for real web service calling test.
|
|
18
18
|
*
|
|
19
|
-
* You could sign up for a free API key at https://www.
|
|
19
|
+
* You could sign up for a free API key at https://www.ip2location.io/pricing
|
|
20
20
|
* if you do not have one.
|
|
21
21
|
*/"
|
|
22
22
|
expect($test_api_key).to eq 'YOUR_API_KEY'
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
|
|
2
|
+
|
|
3
|
+
describe "IP2LocationIORuby" do
|
|
4
|
+
it "work correctly with invalid Api Key" do
|
|
5
|
+
IP2LocationIORuby::Configuration.api_key = ''
|
|
6
|
+
begin
|
|
7
|
+
IP2LocationIORuby::Api::HostedDomain.lookup('1.1.1')
|
|
8
|
+
rescue Exception => e
|
|
9
|
+
expect(e.message).to eq 'Missing parameter.'
|
|
10
|
+
end
|
|
11
|
+
end
|
|
12
|
+
|
|
13
|
+
it "work correctly with Api Key exist" do
|
|
14
|
+
if $test_api_key == 'YOUR_API_KEY'
|
|
15
|
+
print "/*
|
|
16
|
+
* You could enter a IP2Location.io API Key in spec/spec_helper.rb
|
|
17
|
+
* for real web service calling test.
|
|
18
|
+
*
|
|
19
|
+
* You could sign up for a free API key at https://www.ip2location.io/pricing
|
|
20
|
+
* if you do not have one.
|
|
21
|
+
*/"
|
|
22
|
+
expect($test_api_key).to eq 'YOUR_API_KEY'
|
|
23
|
+
else
|
|
24
|
+
expect($test_api_key).to_not eq 'YOUR_API_KEY'
|
|
25
|
+
end
|
|
26
|
+
end
|
|
27
|
+
|
|
28
|
+
it "work correctly with lookup hosted domains" do
|
|
29
|
+
IP2LocationIORuby::Configuration.api_key = $test_api_key
|
|
30
|
+
if $test_api_key == 'YOUR_API_KEY'
|
|
31
|
+
begin
|
|
32
|
+
IP2LocationIORuby::Api::HostedDomain.lookup('1.1.1')
|
|
33
|
+
rescue Exception => e
|
|
34
|
+
expect(e.message).to eq 'API key not found.'
|
|
35
|
+
end
|
|
36
|
+
else
|
|
37
|
+
begin
|
|
38
|
+
result = IP2LocationIORuby::Api::HostedDomain.lookup('1.1.1')
|
|
39
|
+
rescue Exception => e
|
|
40
|
+
expect(e.message).to eq 'Invalid IP address.'
|
|
41
|
+
end
|
|
42
|
+
end
|
|
43
|
+
end
|
|
44
|
+
|
|
45
|
+
end
|
|
@@ -13,10 +13,10 @@ describe "IP2LocationIORuby" do
|
|
|
13
13
|
it "work correctly with Api Key exist" do
|
|
14
14
|
if $test_api_key == 'YOUR_API_KEY'
|
|
15
15
|
print "/*
|
|
16
|
-
* You could enter a
|
|
16
|
+
* You could enter a IP2Location.io API Key in spec/spec_helper.rb
|
|
17
17
|
* for real web service calling test.
|
|
18
18
|
*
|
|
19
|
-
* You could sign up for a free API key at https://www.
|
|
19
|
+
* You could sign up for a free API key at https://www.ip2location.io/pricing
|
|
20
20
|
* if you do not have one.
|
|
21
21
|
*/"
|
|
22
22
|
expect($test_api_key).to eq 'YOUR_API_KEY'
|
metadata
CHANGED
|
@@ -1,15 +1,28 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: ip2location_io_ruby
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.1.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- IP2Location
|
|
8
|
-
autorequire:
|
|
9
8
|
bindir: bin
|
|
10
9
|
cert_chain: []
|
|
11
|
-
date:
|
|
12
|
-
dependencies:
|
|
10
|
+
date: 2025-04-04 00:00:00.000000000 Z
|
|
11
|
+
dependencies:
|
|
12
|
+
- !ruby/object:Gem::Dependency
|
|
13
|
+
name: simpleidn
|
|
14
|
+
requirement: !ruby/object:Gem::Requirement
|
|
15
|
+
requirements:
|
|
16
|
+
- - "~>"
|
|
17
|
+
- !ruby/object:Gem::Version
|
|
18
|
+
version: '0.2'
|
|
19
|
+
type: :runtime
|
|
20
|
+
prerelease: false
|
|
21
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
22
|
+
requirements:
|
|
23
|
+
- - "~>"
|
|
24
|
+
- !ruby/object:Gem::Version
|
|
25
|
+
version: '0.2'
|
|
13
26
|
description: IP2Location.IO Ruby SDK allows user to query for an enriched data set
|
|
14
27
|
based on IP address and provides WHOIS lookup api that helps users to obtain domain
|
|
15
28
|
information.
|
|
@@ -31,17 +44,22 @@ files:
|
|
|
31
44
|
- lib/ip2location_io_ruby.rb
|
|
32
45
|
- lib/ip2location_io_ruby/api.rb
|
|
33
46
|
- lib/ip2location_io_ruby/api/domainwhois.rb
|
|
47
|
+
- lib/ip2location_io_ruby/api/hosteddomain.rb
|
|
34
48
|
- lib/ip2location_io_ruby/api/ipgeolocation.rb
|
|
35
49
|
- lib/ip2location_io_ruby/configuration.rb
|
|
36
50
|
- lib/ip2location_io_ruby/version.rb
|
|
37
51
|
- spec/ip2location_io_ruby_domainwhois_spec.rb
|
|
52
|
+
- spec/ip2location_io_ruby_hosteddomain_spec.rb
|
|
38
53
|
- spec/ip2location_io_ruby_ipgeolocation_spec.rb
|
|
39
54
|
- spec/spec_helper.rb
|
|
40
55
|
homepage: https://github.com/ip2location/ip2location-io-ruby
|
|
41
56
|
licenses:
|
|
42
57
|
- MIT
|
|
43
|
-
metadata:
|
|
44
|
-
|
|
58
|
+
metadata:
|
|
59
|
+
bug_tracker_uri: https://github.com/ip2location/ip2location-io-ruby/issues
|
|
60
|
+
documentation_uri: https://www.rubydoc.info/gems/ip2location_io_ruby
|
|
61
|
+
homepage_uri: https://www.ip2location.io
|
|
62
|
+
source_code_uri: https://github.com/ip2location/ip2location-io-ruby
|
|
45
63
|
rdoc_options: []
|
|
46
64
|
require_paths:
|
|
47
65
|
- lib
|
|
@@ -56,8 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
56
74
|
- !ruby/object:Gem::Version
|
|
57
75
|
version: '0'
|
|
58
76
|
requirements: []
|
|
59
|
-
rubygems_version: 3.
|
|
60
|
-
signing_key:
|
|
77
|
+
rubygems_version: 3.6.4
|
|
61
78
|
specification_version: 4
|
|
62
79
|
summary: IP2Location IO Ruby SDK
|
|
63
80
|
test_files: []
|