cloudmersive-validate-api-client 1.3.4 → 1.4.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +30 -8
- data/cloudmersive-validate-api-client.gemspec +1 -1
- data/docs/AddressApi.md +111 -1
- data/docs/AddressGetServersResponse.md +2 -2
- data/docs/AddressVerifySyntaxOnlyResponse.md +3 -0
- data/docs/DomainApi.md +112 -2
- data/docs/EmailApi.md +3 -3
- data/docs/GetTimezonesRequest.md +8 -0
- data/docs/GetTimezonesResponse.md +13 -0
- data/docs/IPAddressApi.md +1 -1
- data/docs/LeadEnrichmentApi.md +61 -0
- data/docs/LeadEnrichmentRequest.md +21 -0
- data/docs/LeadEnrichmentResponse.md +25 -0
- data/docs/NameApi.md +59 -4
- data/docs/ParseAddressResponse.md +2 -1
- data/docs/PhoneNumberApi.md +1 -1
- data/docs/Timezone.md +9 -0
- data/docs/UserAgentApi.md +63 -0
- data/docs/UserAgentValidateRequest.md +8 -0
- data/docs/UserAgentValidateResponse.md +21 -0
- data/docs/ValidateCountryRequest.md +8 -0
- data/docs/ValidateCountryResponse.md +13 -0
- data/docs/ValidateIdentifierRequest.md +15 -0
- data/docs/ValidateIdentifierResponse.md +9 -0
- data/docs/ValidateUrlRequestFull.md +8 -0
- data/docs/ValidateUrlRequestSyntaxOnly.md +8 -0
- data/docs/ValidateUrlResponseFull.md +12 -0
- data/docs/ValidateUrlResponseSyntaxOnly.md +9 -0
- data/docs/VatApi.md +1 -1
- data/docs/VatLookupRequest.md +1 -1
- data/docs/VatLookupResponse.md +12 -5
- data/docs/WhoisResponse.md +11 -0
- data/lib/cloudmersive-validate-api-client.rb +18 -1
- data/lib/cloudmersive-validate-api-client/api/address_api.rb +112 -2
- data/lib/cloudmersive-validate-api-client/api/domain_api.rb +113 -3
- data/lib/cloudmersive-validate-api-client/api/email_api.rb +4 -4
- data/lib/cloudmersive-validate-api-client/api/ip_address_api.rb +2 -2
- data/lib/cloudmersive-validate-api-client/api/lead_enrichment_api.rb +78 -0
- data/lib/cloudmersive-validate-api-client/api/name_api.rb +60 -5
- data/lib/cloudmersive-validate-api-client/api/phone_number_api.rb +2 -2
- data/lib/cloudmersive-validate-api-client/api/user_agent_api.rb +78 -0
- data/lib/cloudmersive-validate-api-client/api/vat_api.rb +2 -2
- data/lib/cloudmersive-validate-api-client/api_client.rb +1 -1
- data/lib/cloudmersive-validate-api-client/api_error.rb +1 -1
- data/lib/cloudmersive-validate-api-client/configuration.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/address_get_servers_response.rb +3 -1
- data/lib/cloudmersive-validate-api-client/models/address_verify_syntax_only_response.rb +35 -5
- data/lib/cloudmersive-validate-api-client/models/check_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/first_name_validation_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/first_name_validation_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/full_email_validation_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/full_name_validation_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/full_name_validation_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/geolocate_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/get_gender_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/get_gender_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/get_timezones_request.rb +189 -0
- data/lib/cloudmersive-validate-api-client/models/get_timezones_response.rb +241 -0
- data/lib/cloudmersive-validate-api-client/models/last_name_validation_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/last_name_validation_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/lead_enrichment_request.rb +319 -0
- data/lib/cloudmersive-validate-api-client/models/lead_enrichment_response.rb +359 -0
- data/lib/cloudmersive-validate-api-client/models/parse_address_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/parse_address_response.rb +18 -8
- data/lib/cloudmersive-validate-api-client/models/phone_number_validate_request.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/phone_number_validation_response.rb +1 -1
- data/lib/cloudmersive-validate-api-client/models/timezone.rb +199 -0
- data/lib/cloudmersive-validate-api-client/models/user_agent_validate_request.rb +189 -0
- data/lib/cloudmersive-validate-api-client/models/user_agent_validate_response.rb +319 -0
- data/lib/cloudmersive-validate-api-client/models/validate_country_request.rb +189 -0
- data/lib/cloudmersive-validate-api-client/models/validate_country_response.rb +241 -0
- data/lib/cloudmersive-validate-api-client/models/validate_identifier_request.rb +259 -0
- data/lib/cloudmersive-validate-api-client/models/validate_identifier_response.rb +199 -0
- data/lib/cloudmersive-validate-api-client/models/validate_url_request_full.rb +189 -0
- data/lib/cloudmersive-validate-api-client/models/validate_url_request_syntax_only.rb +189 -0
- data/lib/cloudmersive-validate-api-client/models/validate_url_response_full.rb +229 -0
- data/lib/cloudmersive-validate-api-client/models/validate_url_response_syntax_only.rb +199 -0
- data/lib/cloudmersive-validate-api-client/models/vat_lookup_request.rb +2 -1
- data/lib/cloudmersive-validate-api-client/models/vat_lookup_response.rb +80 -5
- data/lib/cloudmersive-validate-api-client/models/whois_response.rb +112 -2
- data/lib/cloudmersive-validate-api-client/version.rb +2 -2
- data/spec/api/address_api_spec.rb +25 -1
- data/spec/api/domain_api_spec.rb +25 -1
- data/spec/api/email_api_spec.rb +1 -1
- data/spec/api/ip_address_api_spec.rb +1 -1
- data/spec/api/lead_enrichment_api_spec.rb +47 -0
- data/spec/api/name_api_spec.rb +13 -1
- data/spec/api/phone_number_api_spec.rb +1 -1
- data/spec/api/user_agent_api_spec.rb +47 -0
- data/spec/api/vat_api_spec.rb +1 -1
- data/spec/api_client_spec.rb +1 -1
- data/spec/configuration_spec.rb +1 -1
- data/spec/models/address_get_servers_response_spec.rb +1 -1
- data/spec/models/address_verify_syntax_only_response_spec.rb +19 -1
- data/spec/models/check_response_spec.rb +1 -1
- data/spec/models/first_name_validation_request_spec.rb +1 -1
- data/spec/models/first_name_validation_response_spec.rb +1 -1
- data/spec/models/full_email_validation_response_spec.rb +1 -1
- data/spec/models/full_name_validation_request_spec.rb +1 -1
- data/spec/models/full_name_validation_response_spec.rb +1 -1
- data/spec/models/geolocate_response_spec.rb +1 -1
- data/spec/models/get_gender_request_spec.rb +1 -1
- data/spec/models/get_gender_response_spec.rb +1 -1
- data/spec/models/get_timezones_request_spec.rb +42 -0
- data/spec/models/get_timezones_response_spec.rb +72 -0
- data/spec/models/last_name_validation_request_spec.rb +1 -1
- data/spec/models/last_name_validation_response_spec.rb +1 -1
- data/spec/models/lead_enrichment_request_spec.rb +120 -0
- data/spec/models/lead_enrichment_response_spec.rb +144 -0
- data/spec/models/parse_address_request_spec.rb +1 -1
- data/spec/models/parse_address_response_spec.rb +8 -2
- data/spec/models/phone_number_validate_request_spec.rb +1 -1
- data/spec/models/phone_number_validation_response_spec.rb +1 -1
- data/spec/models/timezone_spec.rb +48 -0
- data/spec/models/user_agent_validate_request_spec.rb +42 -0
- data/spec/models/user_agent_validate_response_spec.rb +120 -0
- data/spec/models/validate_country_request_spec.rb +42 -0
- data/spec/models/validate_country_response_spec.rb +72 -0
- data/spec/models/validate_identifier_request_spec.rb +84 -0
- data/spec/models/validate_identifier_response_spec.rb +48 -0
- data/spec/models/validate_url_request_full_spec.rb +42 -0
- data/spec/models/validate_url_request_syntax_only_spec.rb +42 -0
- data/spec/models/validate_url_response_full_spec.rb +66 -0
- data/spec/models/validate_url_response_syntax_only_spec.rb +48 -0
- data/spec/models/vat_lookup_request_spec.rb +1 -1
- data/spec/models/vat_lookup_response_spec.rb +43 -1
- data/spec/models/whois_response_spec.rb +67 -1
- data/spec/spec_helper.rb +1 -1
- metadata +66 -16
data/docs/IPAddressApi.md
CHANGED
@@ -56,7 +56,7 @@ Name | Type | Description | Notes
|
|
56
56
|
|
57
57
|
### HTTP request headers
|
58
58
|
|
59
|
-
- **Content-Type**:
|
59
|
+
- **Content-Type**: text/javascript, application/json, text/json
|
60
60
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
61
61
|
|
62
62
|
|
@@ -0,0 +1,61 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::LeadEnrichmentApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://api.cloudmersive.com*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**lead_enrichment_enrich_lead**](LeadEnrichmentApi.md#lead_enrichment_enrich_lead) | **POST** /validate/lead-enrichment/lead/enrich | Enrich an input lead with additional fields of data
|
8
|
+
|
9
|
+
|
10
|
+
# **lead_enrichment_enrich_lead**
|
11
|
+
> LeadEnrichmentResponse lead_enrichment_enrich_lead(request)
|
12
|
+
|
13
|
+
Enrich an input lead with additional fields of data
|
14
|
+
|
15
|
+
### Example
|
16
|
+
```ruby
|
17
|
+
# load the gem
|
18
|
+
require 'cloudmersive-validate-api-client'
|
19
|
+
# setup authorization
|
20
|
+
CloudmersiveValidateApiClient.configure do |config|
|
21
|
+
# Configure API key authorization: Apikey
|
22
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
23
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
24
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
25
|
+
end
|
26
|
+
|
27
|
+
api_instance = CloudmersiveValidateApiClient::LeadEnrichmentApi.new
|
28
|
+
|
29
|
+
request = CloudmersiveValidateApiClient::LeadEnrichmentRequest.new # LeadEnrichmentRequest | Input lead with known fields set, and unknown fields left blank (null)
|
30
|
+
|
31
|
+
|
32
|
+
begin
|
33
|
+
#Enrich an input lead with additional fields of data
|
34
|
+
result = api_instance.lead_enrichment_enrich_lead(request)
|
35
|
+
p result
|
36
|
+
rescue CloudmersiveValidateApiClient::ApiError => e
|
37
|
+
puts "Exception when calling LeadEnrichmentApi->lead_enrichment_enrich_lead: #{e}"
|
38
|
+
end
|
39
|
+
```
|
40
|
+
|
41
|
+
### Parameters
|
42
|
+
|
43
|
+
Name | Type | Description | Notes
|
44
|
+
------------- | ------------- | ------------- | -------------
|
45
|
+
**request** | [**LeadEnrichmentRequest**](LeadEnrichmentRequest.md)| Input lead with known fields set, and unknown fields left blank (null) |
|
46
|
+
|
47
|
+
### Return type
|
48
|
+
|
49
|
+
[**LeadEnrichmentResponse**](LeadEnrichmentResponse.md)
|
50
|
+
|
51
|
+
### Authorization
|
52
|
+
|
53
|
+
[Apikey](../README.md#Apikey)
|
54
|
+
|
55
|
+
### HTTP request headers
|
56
|
+
|
57
|
+
- **Content-Type**: application/json, text/json
|
58
|
+
- **Accept**: application/json, text/json, application/xml, text/xml
|
59
|
+
|
60
|
+
|
61
|
+
|
@@ -0,0 +1,21 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::LeadEnrichmentRequest
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**contact_business_email** | **String** | The person's business email address for the lead | [optional]
|
7
|
+
**contact_first_name** | **String** | The person's first name for the lead | [optional]
|
8
|
+
**contact_last_name** | **String** | The person's last name for the lead | [optional]
|
9
|
+
**company_name** | **String** | Name of the company for the lead | [optional]
|
10
|
+
**company_domain_name** | **String** | Domain name / website for the lead | [optional]
|
11
|
+
**company_house_number** | **String** | House number of the address of the company for the lead | [optional]
|
12
|
+
**company_street** | **String** | Street name of the address of the company for the lead | [optional]
|
13
|
+
**company_city** | **String** | City of the address of the company for the lead | [optional]
|
14
|
+
**company_state_or_province** | **String** | State or Province of the address of the company for the lead | [optional]
|
15
|
+
**company_postal_code** | **String** | Postal Code of the address of the company for the lead | [optional]
|
16
|
+
**company_country** | **String** | Country of the address of the company for the lead | [optional]
|
17
|
+
**company_country_code** | **String** | Country Code (2-letter ISO 3166-1) of the address of the company for the lead | [optional]
|
18
|
+
**company_telephone** | **String** | Telephone of the company office for the lead | [optional]
|
19
|
+
**company_vat_number** | **String** | VAT number of the company for the lead | [optional]
|
20
|
+
|
21
|
+
|
@@ -0,0 +1,25 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::LeadEnrichmentResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**successful** | **BOOLEAN** | True if the operation was successful, false otherwise | [optional]
|
7
|
+
**lead_type** | **String** | The type of the lead; possible types are Junk (a single individual using a disposable/throwaway email address); Individual (a single individual, typically a consumer, not purchasing on behalf of a business); SmallBusiness (a small business, typically with fewer than 100 employees); MediumBusiness (a medium business, larger than 100 employees but fewer than 1000 employees); Enterprise (a large business with greater than 1000 employees); Business (a business customer of unknown size) | [optional]
|
8
|
+
**contact_business_email** | **String** | The person's business email address for the lead | [optional]
|
9
|
+
**contact_first_name** | **String** | The person's first name for the lead | [optional]
|
10
|
+
**contact_last_name** | **String** | The person's last name for the lead | [optional]
|
11
|
+
**contact_gender** | **String** | Gender for contact name; possible values are Male, Female, and Neutral (can be applied to Male or Female). Requires ContactFirstName. | [optional]
|
12
|
+
**company_name** | **String** | Name of the company for the lead | [optional]
|
13
|
+
**company_domain_name** | **String** | Domain name / website for the lead | [optional]
|
14
|
+
**company_house_number** | **String** | House number of the address of the company for the lead | [optional]
|
15
|
+
**company_street** | **String** | Street name of the address of the company for the lead | [optional]
|
16
|
+
**company_city** | **String** | City of the address of the company for the lead | [optional]
|
17
|
+
**company_state_or_province** | **String** | State or Province of the address of the company for the lead | [optional]
|
18
|
+
**company_postal_code** | **String** | Postal Code of the address of the company for the lead | [optional]
|
19
|
+
**company_country** | **String** | Country Name of the address of the company for the lead | [optional]
|
20
|
+
**company_country_code** | **String** | Country Code (2-letter ISO 3166-1) of the address of the company for the lead | [optional]
|
21
|
+
**company_telephone** | **String** | Telephone of the company office for the lead | [optional]
|
22
|
+
**company_vat_number** | **String** | VAT number of the company for the lead | [optional]
|
23
|
+
**employee_count** | **Integer** | Count of employees at the company (estimated), if available | [optional]
|
24
|
+
|
25
|
+
|
data/docs/NameApi.md
CHANGED
@@ -5,6 +5,7 @@ All URIs are relative to *https://api.cloudmersive.com*
|
|
5
5
|
Method | HTTP request | Description
|
6
6
|
------------- | ------------- | -------------
|
7
7
|
[**name_get_gender**](NameApi.md#name_get_gender) | **POST** /validate/name/get-gender | Get the gender of a first name
|
8
|
+
[**name_identifier**](NameApi.md#name_identifier) | **POST** /validate/name/identifier | Validate a code identifier
|
8
9
|
[**name_validate_first_name**](NameApi.md#name_validate_first_name) | **POST** /validate/name/first | Validate a first name
|
9
10
|
[**name_validate_full_name**](NameApi.md#name_validate_full_name) | **POST** /validate/name/full-name | Parse and validate a full name
|
10
11
|
[**name_validate_last_name**](NameApi.md#name_validate_last_name) | **POST** /validate/name/last | Validate a last name
|
@@ -59,7 +60,61 @@ Name | Type | Description | Notes
|
|
59
60
|
|
60
61
|
### HTTP request headers
|
61
62
|
|
62
|
-
- **Content-Type**: application/json, text/json
|
63
|
+
- **Content-Type**: application/json, text/json
|
64
|
+
- **Accept**: application/json, text/json, application/xml, text/xml
|
65
|
+
|
66
|
+
|
67
|
+
|
68
|
+
# **name_identifier**
|
69
|
+
> ValidateIdentifierResponse name_identifier(input)
|
70
|
+
|
71
|
+
Validate a code identifier
|
72
|
+
|
73
|
+
Determines if the input name is a valid technical / code identifier. Configure input rules such as whether whitespace, hyphens, underscores, etc. are allowed. For example, a valid identifier might be \"helloWorld\" but not \"hello*World\".
|
74
|
+
|
75
|
+
### Example
|
76
|
+
```ruby
|
77
|
+
# load the gem
|
78
|
+
require 'cloudmersive-validate-api-client'
|
79
|
+
# setup authorization
|
80
|
+
CloudmersiveValidateApiClient.configure do |config|
|
81
|
+
# Configure API key authorization: Apikey
|
82
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
83
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
84
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
85
|
+
end
|
86
|
+
|
87
|
+
api_instance = CloudmersiveValidateApiClient::NameApi.new
|
88
|
+
|
89
|
+
input = CloudmersiveValidateApiClient::ValidateIdentifierRequest.new # ValidateIdentifierRequest | Identifier validation request information
|
90
|
+
|
91
|
+
|
92
|
+
begin
|
93
|
+
#Validate a code identifier
|
94
|
+
result = api_instance.name_identifier(input)
|
95
|
+
p result
|
96
|
+
rescue CloudmersiveValidateApiClient::ApiError => e
|
97
|
+
puts "Exception when calling NameApi->name_identifier: #{e}"
|
98
|
+
end
|
99
|
+
```
|
100
|
+
|
101
|
+
### Parameters
|
102
|
+
|
103
|
+
Name | Type | Description | Notes
|
104
|
+
------------- | ------------- | ------------- | -------------
|
105
|
+
**input** | [**ValidateIdentifierRequest**](ValidateIdentifierRequest.md)| Identifier validation request information |
|
106
|
+
|
107
|
+
### Return type
|
108
|
+
|
109
|
+
[**ValidateIdentifierResponse**](ValidateIdentifierResponse.md)
|
110
|
+
|
111
|
+
### Authorization
|
112
|
+
|
113
|
+
[Apikey](../README.md#Apikey)
|
114
|
+
|
115
|
+
### HTTP request headers
|
116
|
+
|
117
|
+
- **Content-Type**: application/json, text/json
|
63
118
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
64
119
|
|
65
120
|
|
@@ -113,7 +168,7 @@ Name | Type | Description | Notes
|
|
113
168
|
|
114
169
|
### HTTP request headers
|
115
170
|
|
116
|
-
- **Content-Type**: application/json, text/json
|
171
|
+
- **Content-Type**: application/json, text/json
|
117
172
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
118
173
|
|
119
174
|
|
@@ -167,7 +222,7 @@ Name | Type | Description | Notes
|
|
167
222
|
|
168
223
|
### HTTP request headers
|
169
224
|
|
170
|
-
- **Content-Type**: application/json, text/json
|
225
|
+
- **Content-Type**: application/json, text/json
|
171
226
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
172
227
|
|
173
228
|
|
@@ -221,7 +276,7 @@ Name | Type | Description | Notes
|
|
221
276
|
|
222
277
|
### HTTP request headers
|
223
278
|
|
224
|
-
- **Content-Type**: application/json, text/json
|
279
|
+
- **Content-Type**: application/json, text/json
|
225
280
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
226
281
|
|
227
282
|
|
@@ -10,6 +10,7 @@ Name | Type | Description | Notes
|
|
10
10
|
**city** | **String** | The city of the address. | [optional]
|
11
11
|
**state_or_province** | **String** | The state or province of the address. | [optional]
|
12
12
|
**postal_code** | **String** | The postal code or zip code of the address. | [optional]
|
13
|
-
**
|
13
|
+
**country_full_name** | **String** | Country of the address, if present in the address. If not included in the address it will be null. | [optional]
|
14
|
+
**iso_two_letter_code** | **String** | Two-letter ISO 3166-1 country code | [optional]
|
14
15
|
|
15
16
|
|
data/docs/PhoneNumberApi.md
CHANGED
@@ -56,7 +56,7 @@ Name | Type | Description | Notes
|
|
56
56
|
|
57
57
|
### HTTP request headers
|
58
58
|
|
59
|
-
- **Content-Type**: application/json, text/json
|
59
|
+
- **Content-Type**: application/json, text/json
|
60
60
|
- **Accept**: application/json, text/json, application/xml, text/xml
|
61
61
|
|
62
62
|
|
data/docs/Timezone.md
ADDED
@@ -0,0 +1,9 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::Timezone
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**name** | **String** | Name of the Time Zone | [optional]
|
7
|
+
**base_utc_offset** | **String** | UTC offset for this time zone | [optional]
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,63 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::UserAgentApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://api.cloudmersive.com*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**user_agent_parse**](UserAgentApi.md#user_agent_parse) | **POST** /validate/useragent/parse | Parse an HTTP User-Agent string, identify robots
|
8
|
+
|
9
|
+
|
10
|
+
# **user_agent_parse**
|
11
|
+
> UserAgentValidateResponse user_agent_parse(request)
|
12
|
+
|
13
|
+
Parse an HTTP User-Agent string, identify robots
|
14
|
+
|
15
|
+
Uses a parsing system and database to parse the User-Agent into its structured component parts, such as Browser, Browser Version, Browser Engine, Operating System, and importantly, Robot identification.
|
16
|
+
|
17
|
+
### Example
|
18
|
+
```ruby
|
19
|
+
# load the gem
|
20
|
+
require 'cloudmersive-validate-api-client'
|
21
|
+
# setup authorization
|
22
|
+
CloudmersiveValidateApiClient.configure do |config|
|
23
|
+
# Configure API key authorization: Apikey
|
24
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
25
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
26
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
27
|
+
end
|
28
|
+
|
29
|
+
api_instance = CloudmersiveValidateApiClient::UserAgentApi.new
|
30
|
+
|
31
|
+
request = CloudmersiveValidateApiClient::UserAgentValidateRequest.new # UserAgentValidateRequest | Input parse request
|
32
|
+
|
33
|
+
|
34
|
+
begin
|
35
|
+
#Parse an HTTP User-Agent string, identify robots
|
36
|
+
result = api_instance.user_agent_parse(request)
|
37
|
+
p result
|
38
|
+
rescue CloudmersiveValidateApiClient::ApiError => e
|
39
|
+
puts "Exception when calling UserAgentApi->user_agent_parse: #{e}"
|
40
|
+
end
|
41
|
+
```
|
42
|
+
|
43
|
+
### Parameters
|
44
|
+
|
45
|
+
Name | Type | Description | Notes
|
46
|
+
------------- | ------------- | ------------- | -------------
|
47
|
+
**request** | [**UserAgentValidateRequest**](UserAgentValidateRequest.md)| Input parse request |
|
48
|
+
|
49
|
+
### Return type
|
50
|
+
|
51
|
+
[**UserAgentValidateResponse**](UserAgentValidateResponse.md)
|
52
|
+
|
53
|
+
### Authorization
|
54
|
+
|
55
|
+
[Apikey](../README.md#Apikey)
|
56
|
+
|
57
|
+
### HTTP request headers
|
58
|
+
|
59
|
+
- **Content-Type**: application/json, text/json
|
60
|
+
- **Accept**: application/json, text/json, application/xml, text/xml
|
61
|
+
|
62
|
+
|
63
|
+
|
@@ -0,0 +1,8 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::UserAgentValidateRequest
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**user_agent_string** | **String** | The user agent string you wish to parse and validate | [optional]
|
7
|
+
|
8
|
+
|
@@ -0,0 +1,21 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::UserAgentValidateResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**successful** | **BOOLEAN** | True if the operation was successful, false otherwise | [optional]
|
7
|
+
**is_bot** | **BOOLEAN** | True if the request is a known robot, false otherwise | [optional]
|
8
|
+
**bot_name** | **String** | Optional; name of the robot if the request was from a known robot, otherwise null | [optional]
|
9
|
+
**bot_url** | **String** | Optional; if available, the URL to the robot | [optional]
|
10
|
+
**operating_system** | **String** | Operating System of the User-Agent (e.g. Windows) | [optional]
|
11
|
+
**operating_system_cpu_platform** | **String** | The CPU platform of the User-Agent (e.g. x64) | [optional]
|
12
|
+
**operating_system_version** | **String** | The version of the operating system of the User-Agent (e.g. \"10\" for Windows 10) | [optional]
|
13
|
+
**device_type** | **String** | Device type of the User-Agent; possible values are \"DESKTOP\", \"SMARTPHONE\", \"TABLET\" | [optional]
|
14
|
+
**device_brand_name** | **String** | Brand name of the User-Agent | [optional]
|
15
|
+
**device_model** | **String** | Model name or number of the User-Agent | [optional]
|
16
|
+
**browser_name** | **String** | Name of the Browser | [optional]
|
17
|
+
**browser_version** | **String** | Version of the Browser | [optional]
|
18
|
+
**browser_engine_name** | **String** | Name of the Browser Engine | [optional]
|
19
|
+
**browser_engine_version** | **String** | Version of the Browser Engine | [optional]
|
20
|
+
|
21
|
+
|
@@ -0,0 +1,8 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateCountryRequest
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**raw_country_input** | **String** | Raw country input - can be a two-letter code (FIPS 10-4 or ISO 3166-1), three-letter code (ISO 3166-1) or country name | [optional]
|
7
|
+
|
8
|
+
|
@@ -0,0 +1,13 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateCountryResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**successful** | **BOOLEAN** | True if successful, false otherwise | [optional]
|
7
|
+
**country_full_name** | **String** | Full name of the country | [optional]
|
8
|
+
**iso_two_letter_code** | **String** | Two-letter ISO 3166-1 country code | [optional]
|
9
|
+
**fips_two_letter_code** | **String** | Two-letter FIPS 10-4 country code | [optional]
|
10
|
+
**three_letter_code** | **String** | Three-letter ISO 3166-1 country code | [optional]
|
11
|
+
**timezones** | [**Array<Timezone>**](Timezone.md) | Time zones (IANA/Olsen) in the country | [optional]
|
12
|
+
|
13
|
+
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateIdentifierRequest
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**input** | **String** | Text string identifier input | [optional]
|
7
|
+
**allow_whitespace** | **BOOLEAN** | True if whitespace is allowed in the identifier, false otherwise | [optional]
|
8
|
+
**allow_hyphens** | **BOOLEAN** | True if hyphens are allowd in the identifier, false otherwise | [optional]
|
9
|
+
**allow_underscore** | **BOOLEAN** | True if underscores are allowed in the identifier, false otherwise | [optional]
|
10
|
+
**allow_numbers** | **BOOLEAN** | True if numbers are allowed in the identifier, false otherwise | [optional]
|
11
|
+
**allow_periods** | **BOOLEAN** | True if periods are allowed in the identifier, false otherwise | [optional]
|
12
|
+
**max_length** | **Integer** | Optional; maximum length, if any, of the identifier | [optional]
|
13
|
+
**min_length** | **Integer** | Optional; minimum length, if any, of the identifier | [optional]
|
14
|
+
|
15
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateIdentifierResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**valid_identifier** | **BOOLEAN** | True if the input identifier is valid, false otherwise | [optional]
|
7
|
+
**error** | **String** | Resulting error from the identifier validation; possible errors are: \"InputIsEmpty\", \"ContainsWhitespace\", \"ContainsNumbers\", \"ContainsHyphen\", \"ContainsUnderscore\", \"ContainsPeriod\", \"TooShort\", \"TooLong\", \"ContainsSpecialCharacters\" | [optional]
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,12 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateUrlResponseFull
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**valid_url** | **BOOLEAN** | True if the URL has valid syntax, a valid domain, a valid endpoint, and passes virus scan checks; false otherwise | [optional]
|
7
|
+
**valid_syntax** | **BOOLEAN** | True if the URL has valid syntax, false otherwise | [optional]
|
8
|
+
**valid_domain** | **BOOLEAN** | True if the domain name is valid and exists, false otherwise | [optional]
|
9
|
+
**valid_endpoint** | **BOOLEAN** | True if the endpoint is up and responsive and passes a virus scan check, false otherwise | [optional]
|
10
|
+
**well_formed_url** | **String** | Well-formed version of the URL | [optional]
|
11
|
+
|
12
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# CloudmersiveValidateApiClient::ValidateUrlResponseSyntaxOnly
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**valid_url** | **BOOLEAN** | True if the URL is valid, false otherwise | [optional]
|
7
|
+
**well_formed_url** | **String** | Well-formed version of the URL | [optional]
|
8
|
+
|
9
|
+
|