cloudmersive-phishing-detection-api-client 2.2.0 → 2.2.2
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/README.md +22 -21
- data/cloudmersive-phishing-detection-api-client.gemspec +1 -1
- data/docs/AdvancedEmailDetectionRequest.md +15 -0
- data/docs/AdvancedUrlDetectionRequest.md +9 -0
- data/docs/PhishingDetectionAdvancedRequest.md +18 -0
- data/docs/PhishingDetectionAdvancedResponse.md +11 -0
- data/docs/PhishingDetectionApi.md +284 -0
- data/docs/PhishingDetectionEmailAdvancedResponse.md +17 -0
- data/docs/PhishingDetectionResponse.md +8 -0
- data/docs/PhishingDetectionUrlAdvancedResponse.md +15 -0
- data/lib/cloudmersive-phishing-detection-api-client/api/phishing_detection_api.rb +274 -0
- data/lib/cloudmersive-phishing-detection-api-client/api_client.rb +1 -1
- data/lib/cloudmersive-phishing-detection-api-client/api_error.rb +1 -1
- data/lib/cloudmersive-phishing-detection-api-client/configuration.rb +1 -1
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_advanced_request.rb → advanced_email_detection_request.rb} +83 -46
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_advanced_response_batch.rb → advanced_url_detection_request.rb} +18 -20
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_advanced_request_batch.rb → phishing_detection_advanced_request.rb} +105 -36
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_response_batch.rb → phishing_detection_advanced_response.rb} +32 -14
- data/lib/cloudmersive-phishing-detection-api-client/models/phishing_detection_email_advanced_response.rb +276 -0
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_request.rb → phishing_detection_response.rb} +11 -16
- data/lib/cloudmersive-phishing-detection-api-client/models/{phishing_url_response.rb → phishing_detection_url_advanced_response.rb} +60 -40
- data/lib/cloudmersive-phishing-detection-api-client/version.rb +2 -2
- data/lib/cloudmersive-phishing-detection-api-client.rb +9 -10
- data/spec/api/phishing_detection_api_spec.rb +93 -0
- data/spec/api_client_spec.rb +1 -1
- data/spec/configuration_spec.rb +1 -1
- data/spec/models/advanced_email_detection_request_spec.rb +83 -0
- data/spec/models/{phishing_url_response_batch_spec.rb → advanced_url_detection_request_spec.rb} +9 -9
- data/spec/models/{phishing_url_advanced_response_spec.rb → phishing_detection_advanced_request_spec.rb} +18 -18
- data/spec/models/{phishing_url_response_spec.rb → phishing_detection_advanced_response_spec.rb} +10 -22
- data/spec/models/phishing_detection_email_advanced_response_spec.rb +95 -0
- data/spec/models/{phishing_url_request_spec.rb → phishing_detection_response_spec.rb} +8 -8
- data/spec/models/phishing_detection_url_advanced_response_spec.rb +83 -0
- data/spec/spec_helper.rb +1 -1
- metadata +26 -29
- data/docs/PhishingUrlAdvancedRequest.md +0 -10
- data/docs/PhishingUrlAdvancedRequestBatch.md +0 -10
- data/docs/PhishingUrlAdvancedResponse.md +0 -18
- data/docs/PhishingUrlAdvancedResponseBatch.md +0 -9
- data/docs/PhishingUrlApi.md +0 -120
- data/docs/PhishingUrlBatchApi.md +0 -120
- data/docs/PhishingUrlRequest.md +0 -8
- data/docs/PhishingUrlResponse.md +0 -13
- data/docs/PhishingUrlResponseBatch.md +0 -9
- data/lib/cloudmersive-phishing-detection-api-client/api/phishing_url_api.rb +0 -123
- data/lib/cloudmersive-phishing-detection-api-client/api/phishing_url_batch_api.rb +0 -123
- data/lib/cloudmersive-phishing-detection-api-client/models/phishing_url_advanced_response.rb +0 -286
- data/spec/api/phishing_url_api_spec.rb +0 -59
- data/spec/api/phishing_url_batch_api_spec.rb +0 -59
- data/spec/models/phishing_url_advanced_request_batch_spec.rb +0 -53
- data/spec/models/phishing_url_advanced_request_spec.rb +0 -53
- data/spec/models/phishing_url_advanced_response_batch_spec.rb +0 -47
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d09cb2566e6ef13fd750ea52942b7683cbbd4da4607681fb3f03e37e871f0b89
|
|
4
|
+
data.tar.gz: f0686bd696fc9b3e8233cbb89e008c875f214fd9e3f9f16f874b84c167667979
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: b5f0975e3527703e05ef19efbe872dfb58ee8ae48f56a75adae5b8640e9ce5339d27b2e472c8f1d9033851a8d929ebb92d2626532961900595ec647a319c1a9e
|
|
7
|
+
data.tar.gz: 2aa1472249ba3fb4ece7666304239ceeeecae553daacb98c8951e1c9d21b82dd1061772ba124c5a3099c01d6fb6b3f178927fc36e3380ce207e88e16d0a75b7e
|
data/README.md
CHANGED
|
@@ -2,12 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
CloudmersivePhishingDetectionApiClient - the Ruby gem for the phishingapi
|
|
4
4
|
|
|
5
|
-
Easily and directly scan and block phishing security threats.
|
|
5
|
+
Easily and directly scan and block phishing security threats in input.
|
|
6
6
|
|
|
7
7
|
This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
|
|
8
8
|
|
|
9
9
|
- API version: v1
|
|
10
|
-
- Package version: 2.2.
|
|
10
|
+
- Package version: 2.2.2
|
|
11
11
|
- Build package: io.swagger.codegen.languages.RubyClientCodegen
|
|
12
12
|
|
|
13
13
|
## Installation
|
|
@@ -23,15 +23,15 @@ gem build cloudmersive-phishing-detection-api-client.gemspec
|
|
|
23
23
|
Then either install the gem locally:
|
|
24
24
|
|
|
25
25
|
```shell
|
|
26
|
-
gem install ./cloudmersive-phishing-detection-api-client-2.2.
|
|
26
|
+
gem install ./cloudmersive-phishing-detection-api-client-2.2.2.gem
|
|
27
27
|
```
|
|
28
|
-
(for development, run `gem install --dev ./cloudmersive-phishing-detection-api-client-2.2.
|
|
28
|
+
(for development, run `gem install --dev ./cloudmersive-phishing-detection-api-client-2.2.2.gem` to install the development dependencies)
|
|
29
29
|
|
|
30
30
|
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
|
31
31
|
|
|
32
32
|
Finally add this to the Gemfile:
|
|
33
33
|
|
|
34
|
-
gem 'cloudmersive-phishing-detection-api-client', '~> 2.2.
|
|
34
|
+
gem 'cloudmersive-phishing-detection-api-client', '~> 2.2.2'
|
|
35
35
|
|
|
36
36
|
### Install from Git
|
|
37
37
|
|
|
@@ -62,18 +62,18 @@ CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
|
62
62
|
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
63
63
|
end
|
|
64
64
|
|
|
65
|
-
api_instance = CloudmersivePhishingDetectionApiClient::
|
|
65
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
66
66
|
|
|
67
67
|
opts = {
|
|
68
|
-
body: CloudmersivePhishingDetectionApiClient::
|
|
68
|
+
body: CloudmersivePhishingDetectionApiClient::AdvancedEmailDetectionRequest.new # AdvancedEmailDetectionRequest | Phishing detection request
|
|
69
69
|
}
|
|
70
70
|
|
|
71
71
|
begin
|
|
72
|
-
#
|
|
73
|
-
result = api_instance.
|
|
72
|
+
#Perform advanced AI phishing detection and classification against input email. Analyzes input email as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
73
|
+
result = api_instance.phishing_detect_email_advanced_post(opts)
|
|
74
74
|
p result
|
|
75
75
|
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
76
|
-
puts "Exception when calling
|
|
76
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_email_advanced_post: #{e}"
|
|
77
77
|
end
|
|
78
78
|
|
|
79
79
|
```
|
|
@@ -84,21 +84,22 @@ All URIs are relative to *https://localhost*
|
|
|
84
84
|
|
|
85
85
|
Class | Method | HTTP request | Description
|
|
86
86
|
------------ | ------------- | ------------- | -------------
|
|
87
|
-
*CloudmersivePhishingDetectionApiClient::
|
|
88
|
-
*CloudmersivePhishingDetectionApiClient::
|
|
89
|
-
*CloudmersivePhishingDetectionApiClient::
|
|
90
|
-
*CloudmersivePhishingDetectionApiClient::
|
|
87
|
+
*CloudmersivePhishingDetectionApiClient::PhishingDetectionApi* | [**phishing_detect_email_advanced_post**](docs/PhishingDetectionApi.md#phishing_detect_email_advanced_post) | **POST** /phishing/detect/email/advanced | Perform advanced AI phishing detection and classification against input email. Analyzes input email as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
88
|
+
*CloudmersivePhishingDetectionApiClient::PhishingDetectionApi* | [**phishing_detect_file_advanced_post**](docs/PhishingDetectionApi.md#phishing_detect_file_advanced_post) | **POST** /phishing/detect/file/advanced | Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
89
|
+
*CloudmersivePhishingDetectionApiClient::PhishingDetectionApi* | [**phishing_detect_file_post**](docs/PhishingDetectionApi.md#phishing_detect_file_post) | **POST** /phishing/detect/file | Perform AI phishing detection and classification on an input image or document (PDF or DOCX). Analyzes input content as well as embedded URLs with AI deep learnign to detect phishing and other unsafe content. Uses 100-125 API calls depending on model selected.
|
|
90
|
+
*CloudmersivePhishingDetectionApiClient::PhishingDetectionApi* | [**phishing_detect_text_string_advanced_post**](docs/PhishingDetectionApi.md#phishing_detect_text_string_advanced_post) | **POST** /phishing/detect/text-string/advanced | Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learnign to detect spam, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
91
|
+
*CloudmersivePhishingDetectionApiClient::PhishingDetectionApi* | [**phishing_detect_url_advanced_post**](docs/PhishingDetectionApi.md#phishing_detect_url_advanced_post) | **POST** /phishing/detect/url/advanced | Perform advanced AI phishing detection and classification against an input URL. Retrieves the URL content, checks for SSRF threats, and analyzes the page with AI deep learning to detect phishing and other unsafe content. Uses 100-125 API calls.
|
|
91
92
|
|
|
92
93
|
|
|
93
94
|
## Documentation for Models
|
|
94
95
|
|
|
95
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
96
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
97
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
98
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
99
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
100
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
101
|
-
- [CloudmersivePhishingDetectionApiClient::
|
|
96
|
+
- [CloudmersivePhishingDetectionApiClient::AdvancedEmailDetectionRequest](docs/AdvancedEmailDetectionRequest.md)
|
|
97
|
+
- [CloudmersivePhishingDetectionApiClient::AdvancedUrlDetectionRequest](docs/AdvancedUrlDetectionRequest.md)
|
|
98
|
+
- [CloudmersivePhishingDetectionApiClient::PhishingDetectionAdvancedRequest](docs/PhishingDetectionAdvancedRequest.md)
|
|
99
|
+
- [CloudmersivePhishingDetectionApiClient::PhishingDetectionAdvancedResponse](docs/PhishingDetectionAdvancedResponse.md)
|
|
100
|
+
- [CloudmersivePhishingDetectionApiClient::PhishingDetectionEmailAdvancedResponse](docs/PhishingDetectionEmailAdvancedResponse.md)
|
|
101
|
+
- [CloudmersivePhishingDetectionApiClient::PhishingDetectionResponse](docs/PhishingDetectionResponse.md)
|
|
102
|
+
- [CloudmersivePhishingDetectionApiClient::PhishingDetectionUrlAdvancedResponse](docs/PhishingDetectionUrlAdvancedResponse.md)
|
|
102
103
|
|
|
103
104
|
|
|
104
105
|
## Documentation for Authorization
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::AdvancedEmailDetectionRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**from_email_address** | **String** | Email address of the sender | [optional]
|
|
7
|
+
**to_email_address** | **String** | Email address of the recipient | [optional]
|
|
8
|
+
**subject** | **String** | Subject of the email | [optional]
|
|
9
|
+
**html_body** | **String** | Body of the email in HTML, or text | [optional]
|
|
10
|
+
**allow_low_reputation_senders** | **BOOLEAN** | Allow email from low reputation senders and domains | [optional]
|
|
11
|
+
**allow_sanctioned** | **BOOLEAN** | True to allow sanctioned countries and certain known sanctioned entities, false otherwise (default) | [optional]
|
|
12
|
+
**custom_policy_id** | **String** | Apply a Custom Policy for Phishing Enforcement by providing the ID; to create a Custom Policy, navigate to the Cloudmersive Management Portal and select Custom Policies. Requires Managed Instance or Private Cloud | [optional]
|
|
13
|
+
**input_email_file** | **String** | Optional: Input email file bytes (EML, PDF, etc.). If not provided, HtmlBody will be used instead. | [optional]
|
|
14
|
+
|
|
15
|
+
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::AdvancedUrlDetectionRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**url** | **String** | URL to check for phishing | [optional]
|
|
7
|
+
**custom_policy_id** | **String** | Apply a Custom Policy for Phishing Enforcement by providing the ID; to create a Custom Policy, navigate to the Cloudmersive Management Portal and select Custom Policies. Requires Managed Instance or Private Cloud | [optional]
|
|
8
|
+
|
|
9
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionAdvancedRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**input_string** | **String** | Input text string to detect phishing against | [optional]
|
|
7
|
+
**model** | **String** | Optional: Specify which AI model to use. Possible choices are Normal and Advanced. Default is Advanced. | [optional]
|
|
8
|
+
**custom_policy_id** | **String** | Apply a Custom Policy for Phishing Enforcement by providing the ID; to create a Custom Policy, navigate to the Cloudmersive Management Portal and select Custom Policies. Requires Managed Instance or Private Cloud | [optional]
|
|
9
|
+
**provide_analysis_rationale** | **BOOLEAN** | Optional: Set to true to include an analysis rationale in the response explaining why the content was or was not flagged. Default is true. | [optional]
|
|
10
|
+
**text_type** | **String** | Optional: Type of text being analyzed. Must be one of: \"Text Message\", \"User Message\", \"Sales Lead\", \"Email Message\", \"Support Case\", \"Other\". | [optional]
|
|
11
|
+
**from_name** | **String** | Optional: Name of the sender | [optional]
|
|
12
|
+
**to_name** | **String** | Optional: Name of the recipient | [optional]
|
|
13
|
+
**from_phone_number** | **String** | Optional: Phone number of the sender | [optional]
|
|
14
|
+
**to_phone_number** | **String** | Optional: Phone number of the recipient | [optional]
|
|
15
|
+
**from_email_address** | **String** | Optional: Email address of the sender | [optional]
|
|
16
|
+
**to_email_address** | **String** | Optional: Email address of the recipient | [optional]
|
|
17
|
+
|
|
18
|
+
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionAdvancedResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**clean_result** | **BOOLEAN** | True if the result is not phishing (clean), and false otherwise | [optional]
|
|
7
|
+
**phishing_risk_level** | **Float** | Overall phishing risk level between 0.0 and 1.0 | [optional]
|
|
8
|
+
**confidence_level** | **Float** | Confidence level between 0.0 and 1.0 where values over 0.9 indicate high confidence | [optional]
|
|
9
|
+
**analysis_rationale** | **String** | Rationale for why the conclusion was formed | [optional]
|
|
10
|
+
|
|
11
|
+
|
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionApi
|
|
2
|
+
|
|
3
|
+
All URIs are relative to *https://localhost*
|
|
4
|
+
|
|
5
|
+
Method | HTTP request | Description
|
|
6
|
+
------------- | ------------- | -------------
|
|
7
|
+
[**phishing_detect_email_advanced_post**](PhishingDetectionApi.md#phishing_detect_email_advanced_post) | **POST** /phishing/detect/email/advanced | Perform advanced AI phishing detection and classification against input email. Analyzes input email as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
8
|
+
[**phishing_detect_file_advanced_post**](PhishingDetectionApi.md#phishing_detect_file_advanced_post) | **POST** /phishing/detect/file/advanced | Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
9
|
+
[**phishing_detect_file_post**](PhishingDetectionApi.md#phishing_detect_file_post) | **POST** /phishing/detect/file | Perform AI phishing detection and classification on an input image or document (PDF or DOCX). Analyzes input content as well as embedded URLs with AI deep learnign to detect phishing and other unsafe content. Uses 100-125 API calls depending on model selected.
|
|
10
|
+
[**phishing_detect_text_string_advanced_post**](PhishingDetectionApi.md#phishing_detect_text_string_advanced_post) | **POST** /phishing/detect/text-string/advanced | Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learnign to detect spam, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
11
|
+
[**phishing_detect_url_advanced_post**](PhishingDetectionApi.md#phishing_detect_url_advanced_post) | **POST** /phishing/detect/url/advanced | Perform advanced AI phishing detection and classification against an input URL. Retrieves the URL content, checks for SSRF threats, and analyzes the page with AI deep learning to detect phishing and other unsafe content. Uses 100-125 API calls.
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
# **phishing_detect_email_advanced_post**
|
|
15
|
+
> PhishingDetectionEmailAdvancedResponse phishing_detect_email_advanced_post(opts)
|
|
16
|
+
|
|
17
|
+
Perform advanced AI phishing detection and classification against input email. Analyzes input email as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
18
|
+
|
|
19
|
+
### Example
|
|
20
|
+
```ruby
|
|
21
|
+
# load the gem
|
|
22
|
+
require 'cloudmersive-phishing-detection-api-client'
|
|
23
|
+
# setup authorization
|
|
24
|
+
CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
25
|
+
# Configure API key authorization: Apikey
|
|
26
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
|
27
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
|
28
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
29
|
+
end
|
|
30
|
+
|
|
31
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
32
|
+
|
|
33
|
+
opts = {
|
|
34
|
+
body: CloudmersivePhishingDetectionApiClient::AdvancedEmailDetectionRequest.new # AdvancedEmailDetectionRequest | Phishing detection request
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
begin
|
|
38
|
+
#Perform advanced AI phishing detection and classification against input email. Analyzes input email as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
39
|
+
result = api_instance.phishing_detect_email_advanced_post(opts)
|
|
40
|
+
p result
|
|
41
|
+
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
42
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_email_advanced_post: #{e}"
|
|
43
|
+
end
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Parameters
|
|
47
|
+
|
|
48
|
+
Name | Type | Description | Notes
|
|
49
|
+
------------- | ------------- | ------------- | -------------
|
|
50
|
+
**body** | [**AdvancedEmailDetectionRequest**](AdvancedEmailDetectionRequest.md)| Phishing detection request | [optional]
|
|
51
|
+
|
|
52
|
+
### Return type
|
|
53
|
+
|
|
54
|
+
[**PhishingDetectionEmailAdvancedResponse**](PhishingDetectionEmailAdvancedResponse.md)
|
|
55
|
+
|
|
56
|
+
### Authorization
|
|
57
|
+
|
|
58
|
+
[Apikey](../README.md#Apikey)
|
|
59
|
+
|
|
60
|
+
### HTTP request headers
|
|
61
|
+
|
|
62
|
+
- **Content-Type**: application/json, text/json, application/*+json
|
|
63
|
+
- **Accept**: text/plain, application/json, text/json
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
# **phishing_detect_file_advanced_post**
|
|
68
|
+
> PhishingDetectionAdvancedResponse phishing_detect_file_advanced_post(opts)
|
|
69
|
+
|
|
70
|
+
Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
71
|
+
|
|
72
|
+
### Example
|
|
73
|
+
```ruby
|
|
74
|
+
# load the gem
|
|
75
|
+
require 'cloudmersive-phishing-detection-api-client'
|
|
76
|
+
# setup authorization
|
|
77
|
+
CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
78
|
+
# Configure API key authorization: Apikey
|
|
79
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
|
80
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
|
81
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
82
|
+
end
|
|
83
|
+
|
|
84
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
85
|
+
|
|
86
|
+
opts = {
|
|
87
|
+
model: 'Advanced', # String |
|
|
88
|
+
custom_policy_id: 'custom_policy_id_example', # String |
|
|
89
|
+
input_file: File.new('/path/to/file.txt') # File |
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
begin
|
|
93
|
+
#Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learning to detect phishing, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
94
|
+
result = api_instance.phishing_detect_file_advanced_post(opts)
|
|
95
|
+
p result
|
|
96
|
+
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
97
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_file_advanced_post: #{e}"
|
|
98
|
+
end
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Parameters
|
|
102
|
+
|
|
103
|
+
Name | Type | Description | Notes
|
|
104
|
+
------------- | ------------- | ------------- | -------------
|
|
105
|
+
**model** | **String**| | [optional] [default to Advanced]
|
|
106
|
+
**custom_policy_id** | **String**| | [optional]
|
|
107
|
+
**input_file** | **File**| | [optional]
|
|
108
|
+
|
|
109
|
+
### Return type
|
|
110
|
+
|
|
111
|
+
[**PhishingDetectionAdvancedResponse**](PhishingDetectionAdvancedResponse.md)
|
|
112
|
+
|
|
113
|
+
### Authorization
|
|
114
|
+
|
|
115
|
+
[Apikey](../README.md#Apikey)
|
|
116
|
+
|
|
117
|
+
### HTTP request headers
|
|
118
|
+
|
|
119
|
+
- **Content-Type**: multipart/form-data
|
|
120
|
+
- **Accept**: text/plain, application/json, text/json
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
# **phishing_detect_file_post**
|
|
125
|
+
> PhishingDetectionResponse phishing_detect_file_post(opts)
|
|
126
|
+
|
|
127
|
+
Perform AI phishing detection and classification on an input image or document (PDF or DOCX). Analyzes input content as well as embedded URLs with AI deep learnign to detect phishing and other unsafe content. Uses 100-125 API calls depending on model selected.
|
|
128
|
+
|
|
129
|
+
### Example
|
|
130
|
+
```ruby
|
|
131
|
+
# load the gem
|
|
132
|
+
require 'cloudmersive-phishing-detection-api-client'
|
|
133
|
+
# setup authorization
|
|
134
|
+
CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
135
|
+
# Configure API key authorization: Apikey
|
|
136
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
|
137
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
|
138
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
139
|
+
end
|
|
140
|
+
|
|
141
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
142
|
+
|
|
143
|
+
opts = {
|
|
144
|
+
model: 'Advanced', # String | Model to use; default setting is Advanced
|
|
145
|
+
input_file: File.new('/path/to/file.txt') # File |
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
begin
|
|
149
|
+
#Perform AI phishing detection and classification on an input image or document (PDF or DOCX). Analyzes input content as well as embedded URLs with AI deep learnign to detect phishing and other unsafe content. Uses 100-125 API calls depending on model selected.
|
|
150
|
+
result = api_instance.phishing_detect_file_post(opts)
|
|
151
|
+
p result
|
|
152
|
+
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
153
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_file_post: #{e}"
|
|
154
|
+
end
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Parameters
|
|
158
|
+
|
|
159
|
+
Name | Type | Description | Notes
|
|
160
|
+
------------- | ------------- | ------------- | -------------
|
|
161
|
+
**model** | **String**| Model to use; default setting is Advanced | [optional] [default to Advanced]
|
|
162
|
+
**input_file** | **File**| | [optional]
|
|
163
|
+
|
|
164
|
+
### Return type
|
|
165
|
+
|
|
166
|
+
[**PhishingDetectionResponse**](PhishingDetectionResponse.md)
|
|
167
|
+
|
|
168
|
+
### Authorization
|
|
169
|
+
|
|
170
|
+
[Apikey](../README.md#Apikey)
|
|
171
|
+
|
|
172
|
+
### HTTP request headers
|
|
173
|
+
|
|
174
|
+
- **Content-Type**: multipart/form-data
|
|
175
|
+
- **Accept**: text/plain, application/json, text/json
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
# **phishing_detect_text_string_advanced_post**
|
|
180
|
+
> PhishingDetectionAdvancedResponse phishing_detect_text_string_advanced_post(opts)
|
|
181
|
+
|
|
182
|
+
Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learnign to detect spam, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
183
|
+
|
|
184
|
+
### Example
|
|
185
|
+
```ruby
|
|
186
|
+
# load the gem
|
|
187
|
+
require 'cloudmersive-phishing-detection-api-client'
|
|
188
|
+
# setup authorization
|
|
189
|
+
CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
190
|
+
# Configure API key authorization: Apikey
|
|
191
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
|
192
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
|
193
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
194
|
+
end
|
|
195
|
+
|
|
196
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
197
|
+
|
|
198
|
+
opts = {
|
|
199
|
+
body: CloudmersivePhishingDetectionApiClient::PhishingDetectionAdvancedRequest.new # PhishingDetectionAdvancedRequest | Phishing detection request
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
begin
|
|
203
|
+
#Perform advanced AI phishing detection and classification against input text string. Analyzes input content as well as embedded URLs with AI deep learnign to detect spam, phishing and other unsafe content. Uses 25-100 API calls depending on model selected.
|
|
204
|
+
result = api_instance.phishing_detect_text_string_advanced_post(opts)
|
|
205
|
+
p result
|
|
206
|
+
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
207
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_text_string_advanced_post: #{e}"
|
|
208
|
+
end
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Parameters
|
|
212
|
+
|
|
213
|
+
Name | Type | Description | Notes
|
|
214
|
+
------------- | ------------- | ------------- | -------------
|
|
215
|
+
**body** | [**PhishingDetectionAdvancedRequest**](PhishingDetectionAdvancedRequest.md)| Phishing detection request | [optional]
|
|
216
|
+
|
|
217
|
+
### Return type
|
|
218
|
+
|
|
219
|
+
[**PhishingDetectionAdvancedResponse**](PhishingDetectionAdvancedResponse.md)
|
|
220
|
+
|
|
221
|
+
### Authorization
|
|
222
|
+
|
|
223
|
+
[Apikey](../README.md#Apikey)
|
|
224
|
+
|
|
225
|
+
### HTTP request headers
|
|
226
|
+
|
|
227
|
+
- **Content-Type**: application/json, text/json, application/*+json
|
|
228
|
+
- **Accept**: text/plain, application/json, text/json
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
|
|
232
|
+
# **phishing_detect_url_advanced_post**
|
|
233
|
+
> PhishingDetectionUrlAdvancedResponse phishing_detect_url_advanced_post(opts)
|
|
234
|
+
|
|
235
|
+
Perform advanced AI phishing detection and classification against an input URL. Retrieves the URL content, checks for SSRF threats, and analyzes the page with AI deep learning to detect phishing and other unsafe content. Uses 100-125 API calls.
|
|
236
|
+
|
|
237
|
+
### Example
|
|
238
|
+
```ruby
|
|
239
|
+
# load the gem
|
|
240
|
+
require 'cloudmersive-phishing-detection-api-client'
|
|
241
|
+
# setup authorization
|
|
242
|
+
CloudmersivePhishingDetectionApiClient.configure do |config|
|
|
243
|
+
# Configure API key authorization: Apikey
|
|
244
|
+
config.api_key['Apikey'] = 'YOUR API KEY'
|
|
245
|
+
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
|
|
246
|
+
#config.api_key_prefix['Apikey'] = 'Bearer'
|
|
247
|
+
end
|
|
248
|
+
|
|
249
|
+
api_instance = CloudmersivePhishingDetectionApiClient::PhishingDetectionApi.new
|
|
250
|
+
|
|
251
|
+
opts = {
|
|
252
|
+
body: CloudmersivePhishingDetectionApiClient::AdvancedUrlDetectionRequest.new # AdvancedUrlDetectionRequest | URL phishing detection request
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
begin
|
|
256
|
+
#Perform advanced AI phishing detection and classification against an input URL. Retrieves the URL content, checks for SSRF threats, and analyzes the page with AI deep learning to detect phishing and other unsafe content. Uses 100-125 API calls.
|
|
257
|
+
result = api_instance.phishing_detect_url_advanced_post(opts)
|
|
258
|
+
p result
|
|
259
|
+
rescue CloudmersivePhishingDetectionApiClient::ApiError => e
|
|
260
|
+
puts "Exception when calling PhishingDetectionApi->phishing_detect_url_advanced_post: #{e}"
|
|
261
|
+
end
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
### Parameters
|
|
265
|
+
|
|
266
|
+
Name | Type | Description | Notes
|
|
267
|
+
------------- | ------------- | ------------- | -------------
|
|
268
|
+
**body** | [**AdvancedUrlDetectionRequest**](AdvancedUrlDetectionRequest.md)| URL phishing detection request | [optional]
|
|
269
|
+
|
|
270
|
+
### Return type
|
|
271
|
+
|
|
272
|
+
[**PhishingDetectionUrlAdvancedResponse**](PhishingDetectionUrlAdvancedResponse.md)
|
|
273
|
+
|
|
274
|
+
### Authorization
|
|
275
|
+
|
|
276
|
+
[Apikey](../README.md#Apikey)
|
|
277
|
+
|
|
278
|
+
### HTTP request headers
|
|
279
|
+
|
|
280
|
+
- **Content-Type**: application/json, text/json, application/*+json
|
|
281
|
+
- **Accept**: text/plain, application/json, text/json
|
|
282
|
+
|
|
283
|
+
|
|
284
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionEmailAdvancedResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**clean_result** | **BOOLEAN** | True if the result is not phishing (clean), and false otherwise | [optional]
|
|
7
|
+
**phishing_risk_level** | **Float** | Overall phishing risk level between 0.0 and 1.0 | [optional]
|
|
8
|
+
**spam_risk_level** | **Float** | Overall phishing spam level between 0.0 and 1.0 | [optional]
|
|
9
|
+
**contains_low_reputation_sender** | **BOOLEAN** | True if the input email is from a low reputation sender | [optional]
|
|
10
|
+
**contains_phishing** | **BOOLEAN** | True if the input email contains phishing threat risks, false otherwise | [optional]
|
|
11
|
+
**contains_spam** | **BOOLEAN** | True if the email contains phishing threat risks, false otherwise | [optional]
|
|
12
|
+
**contains_unsolicited_sales** | **BOOLEAN** | True if the input email contains unsolicited sales, false otherwise | [optional]
|
|
13
|
+
**contains_promotional_content** | **BOOLEAN** | True if the input email contains promotional content, false otherwise | [optional]
|
|
14
|
+
**contains_phishing_attempt** | **BOOLEAN** | True if the input email contains a phishing attempt, false otherwise | [optional]
|
|
15
|
+
**analysis_rationale** | **String** | Rationale for why the conclusion was formed | [optional]
|
|
16
|
+
|
|
17
|
+
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**clean_result** | **BOOLEAN** | True if the result is not phishing (clean), and false otherwise | [optional]
|
|
7
|
+
|
|
8
|
+
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# CloudmersivePhishingDetectionApiClient::PhishingDetectionUrlAdvancedResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
Name | Type | Description | Notes
|
|
5
|
+
------------ | ------------- | ------------- | -------------
|
|
6
|
+
**clean_result** | **BOOLEAN** | True if the result is not phishing (clean), and false otherwise | [optional]
|
|
7
|
+
**phishing_risk_level** | **Float** | Overall phishing risk level between 0.0 and 1.0 | [optional]
|
|
8
|
+
**is_ssrf_threat** | **BOOLEAN** | True if the URL is an SSRF threat | [optional]
|
|
9
|
+
**contains_phishing** | **BOOLEAN** | True if the URL contains phishing threat risks, false otherwise | [optional]
|
|
10
|
+
**contains_unsolicited_sales** | **BOOLEAN** | True if the URL contains unsolicited sales, false otherwise | [optional]
|
|
11
|
+
**contains_promotional_content** | **BOOLEAN** | True if the URL contains promotional content, false otherwise | [optional]
|
|
12
|
+
**contains_phishing_attempt** | **BOOLEAN** | True if the URL contains a phishing attempt, false otherwise | [optional]
|
|
13
|
+
**analysis_rationale** | **String** | Rationale for why the conclusion was formed | [optional]
|
|
14
|
+
|
|
15
|
+
|