relentless_identity 1.0.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 +7 -0
- data/Gemfile +9 -0
- data/README.md +143 -0
- data/Rakefile +10 -0
- data/docs/AccountApi.md +219 -0
- data/docs/AliasInfo.md +20 -0
- data/docs/BatchSummary.md +26 -0
- data/docs/ClientBackgroundJobDetailResponse.md +30 -0
- data/docs/ClientBackgroundJobItemResponse.md +48 -0
- data/docs/ClientBackgroundJobPageResponse.md +26 -0
- data/docs/ClientBackgroundJobResponse.md +76 -0
- data/docs/ClientBatchIdentityResponse.md +20 -0
- data/docs/ClientFinderResponse.md +34 -0
- data/docs/ClientFinderResponseAlias.md +20 -0
- data/docs/ClientIdentityResponse.md +34 -0
- data/docs/ClientRequestHistoryItem.md +52 -0
- data/docs/ClientRequestHistoryPageResponse.md +26 -0
- data/docs/ClientTokenStatusResponse.md +28 -0
- data/docs/ClientUsageResponse.md +54 -0
- data/docs/ErrorResponse.md +24 -0
- data/docs/FinderApi.md +77 -0
- data/docs/FinderBatchJobRequest.md +22 -0
- data/docs/FinderBatchJobRequestInputsInner.md +20 -0
- data/docs/FinderRequest.md +20 -0
- data/docs/HTTPValidationError.md +18 -0
- data/docs/IdentityProvider.md +20 -0
- data/docs/JobsApi.md +529 -0
- data/docs/LocationInner.md +15 -0
- data/docs/ProbeApi.md +147 -0
- data/docs/ProbeBatchJobBackgroundRequest.md +22 -0
- data/docs/ProbeBatchRequest.md +18 -0
- data/docs/ProbeRequest.md +18 -0
- data/docs/ValidationError.md +26 -0
- data/git_push.sh +57 -0
- data/lib/relentless_identity/api/account_api.rb +225 -0
- data/lib/relentless_identity/api/finder_api.rb +90 -0
- data/lib/relentless_identity/api/jobs_api.rb +535 -0
- data/lib/relentless_identity/api/probe_api.rb +158 -0
- data/lib/relentless_identity/api_client.rb +397 -0
- data/lib/relentless_identity/api_error.rb +58 -0
- data/lib/relentless_identity/api_model_base.rb +88 -0
- data/lib/relentless_identity/configuration.rb +309 -0
- data/lib/relentless_identity/models/alias_info.rb +159 -0
- data/lib/relentless_identity/models/batch_summary.rb +318 -0
- data/lib/relentless_identity/models/client_background_job_detail_response.rb +307 -0
- data/lib/relentless_identity/models/client_background_job_item_response.rb +455 -0
- data/lib/relentless_identity/models/client_background_job_page_response.rb +271 -0
- data/lib/relentless_identity/models/client_background_job_response.rb +745 -0
- data/lib/relentless_identity/models/client_batch_identity_response.rb +194 -0
- data/lib/relentless_identity/models/client_finder_response.rb +285 -0
- data/lib/relentless_identity/models/client_finder_response_alias.rb +104 -0
- data/lib/relentless_identity/models/client_identity_response.rb +285 -0
- data/lib/relentless_identity/models/client_request_history_item.rb +450 -0
- data/lib/relentless_identity/models/client_request_history_page_response.rb +271 -0
- data/lib/relentless_identity/models/client_token_status_response.rb +259 -0
- data/lib/relentless_identity/models/client_usage_response.rb +506 -0
- data/lib/relentless_identity/models/error_response.rb +178 -0
- data/lib/relentless_identity/models/finder_batch_job_request.rb +206 -0
- data/lib/relentless_identity/models/finder_batch_job_request_inputs_inner.rb +192 -0
- data/lib/relentless_identity/models/finder_request.rb +193 -0
- data/lib/relentless_identity/models/http_validation_error.rb +149 -0
- data/lib/relentless_identity/models/identity_provider.rb +157 -0
- data/lib/relentless_identity/models/location_inner.rb +103 -0
- data/lib/relentless_identity/models/probe_batch_job_background_request.rb +206 -0
- data/lib/relentless_identity/models/probe_batch_request.rb +186 -0
- data/lib/relentless_identity/models/probe_request.rb +166 -0
- data/lib/relentless_identity/models/validation_error.rb +237 -0
- data/lib/relentless_identity/version.rb +15 -0
- data/lib/relentless_identity.rb +69 -0
- data/relentless_identity.gemspec +39 -0
- data/spec/api/account_api_spec.rb +72 -0
- data/spec/api/finder_api_spec.rb +47 -0
- data/spec/api/jobs_api_spec.rb +130 -0
- data/spec/api/probe_api_spec.rb +59 -0
- data/spec/models/alias_info_spec.rb +42 -0
- data/spec/models/batch_summary_spec.rb +60 -0
- data/spec/models/client_background_job_detail_response_spec.rb +72 -0
- data/spec/models/client_background_job_item_response_spec.rb +138 -0
- data/spec/models/client_background_job_page_response_spec.rb +60 -0
- data/spec/models/client_background_job_response_spec.rb +222 -0
- data/spec/models/client_batch_identity_response_spec.rb +42 -0
- data/spec/models/client_finder_response_alias_spec.rb +21 -0
- data/spec/models/client_finder_response_spec.rb +92 -0
- data/spec/models/client_identity_response_spec.rb +92 -0
- data/spec/models/client_request_history_item_spec.rb +150 -0
- data/spec/models/client_request_history_page_response_spec.rb +60 -0
- data/spec/models/client_token_status_response_spec.rb +70 -0
- data/spec/models/client_usage_response_spec.rb +144 -0
- data/spec/models/error_response_spec.rb +54 -0
- data/spec/models/finder_batch_job_request_inputs_inner_spec.rb +42 -0
- data/spec/models/finder_batch_job_request_spec.rb +48 -0
- data/spec/models/finder_request_spec.rb +42 -0
- data/spec/models/http_validation_error_spec.rb +36 -0
- data/spec/models/identity_provider_spec.rb +42 -0
- data/spec/models/location_inner_spec.rb +21 -0
- data/spec/models/probe_batch_job_background_request_spec.rb +48 -0
- data/spec/models/probe_batch_request_spec.rb +36 -0
- data/spec/models/probe_request_spec.rb +36 -0
- data/spec/models/validation_error_spec.rb +60 -0
- data/spec/spec_helper.rb +111 -0
- metadata +213 -0
checksums.yaml
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
---
|
|
2
|
+
SHA256:
|
|
3
|
+
metadata.gz: 834d934cf1f94e2fccf87ea4abd77b262ff1413c77c65729b49aea6d4377a6ec
|
|
4
|
+
data.tar.gz: 842641417f0642347312378cda1811bb0e097804cedb717ec35960d28f12844f
|
|
5
|
+
SHA512:
|
|
6
|
+
metadata.gz: bfaab2de37843312daecb43bbe71b9394cc30388dc5a44d387bc481ac6db029f1a8fb0b38b24d701e24edafe82ceb18280b3a39dd27274b7a830784df588c917
|
|
7
|
+
data.tar.gz: 550fa7044f4871a347506010b2bb8587c12610e07594373790c6fcbaa8c9e05c8a6e19048a2249ea812d785956d09b60513e1f36542af4cef457bfe12faabd15
|
data/Gemfile
ADDED
data/README.md
ADDED
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# relentless_identity
|
|
2
|
+
|
|
3
|
+
RelentlessIdentity - the Ruby gem for the Relentless Identity API
|
|
4
|
+
|
|
5
|
+
Public client API for Finder and Probe workflows. This spec is generated from the FastAPI app, then narrowed to the supported bearer-authenticated routes used by SDKs and the API reference.
|
|
6
|
+
|
|
7
|
+
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
|
+
|
|
9
|
+
- API version: 1.0.0
|
|
10
|
+
- Package version: 1.0.0
|
|
11
|
+
- Generator version: 7.21.0
|
|
12
|
+
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
13
|
+
|
|
14
|
+
## Installation
|
|
15
|
+
|
|
16
|
+
### Build a gem
|
|
17
|
+
|
|
18
|
+
To build the Ruby code into a gem:
|
|
19
|
+
|
|
20
|
+
```shell
|
|
21
|
+
gem build relentless_identity.gemspec
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Then either install the gem locally:
|
|
25
|
+
|
|
26
|
+
```shell
|
|
27
|
+
gem install ./relentless_identity-1.0.0.gem
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
(for development, run `gem install --dev ./relentless_identity-1.0.0.gem` to install the development dependencies)
|
|
31
|
+
|
|
32
|
+
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
|
33
|
+
|
|
34
|
+
Finally add this to the Gemfile:
|
|
35
|
+
|
|
36
|
+
gem 'relentless_identity', '~> 1.0.0'
|
|
37
|
+
|
|
38
|
+
### Install from Git
|
|
39
|
+
|
|
40
|
+
If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
|
|
41
|
+
|
|
42
|
+
gem 'relentless_identity', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
|
|
43
|
+
|
|
44
|
+
### Include the Ruby code directly
|
|
45
|
+
|
|
46
|
+
Include the Ruby code directly using `-I` as follows:
|
|
47
|
+
|
|
48
|
+
```shell
|
|
49
|
+
ruby -Ilib script.rb
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Getting Started
|
|
53
|
+
|
|
54
|
+
Please follow the [installation](#installation) procedure and then run the following code:
|
|
55
|
+
|
|
56
|
+
```ruby
|
|
57
|
+
# Load the gem
|
|
58
|
+
require 'relentless_identity'
|
|
59
|
+
|
|
60
|
+
# Setup authorization
|
|
61
|
+
RelentlessIdentity.configure do |config|
|
|
62
|
+
# Configure Bearer authorization (PAT): bearerAuth
|
|
63
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
64
|
+
# Configure a proc to get access tokens in lieu of the static access_token configuration
|
|
65
|
+
config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' }
|
|
66
|
+
end
|
|
67
|
+
|
|
68
|
+
api_instance = RelentlessIdentity::AccountApi.new
|
|
69
|
+
opts = {
|
|
70
|
+
page: 56, # Integer | Page number starting at 1.
|
|
71
|
+
page_size: 56, # Integer | Number of history rows per page. Maximum 25.
|
|
72
|
+
request_type: 'finder', # String | Optional request-type filter.
|
|
73
|
+
state: 'deliverable' # String | Optional deliverability-state filter.
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
begin
|
|
77
|
+
#Get paginated request history
|
|
78
|
+
result = api_instance.get_request_history(opts)
|
|
79
|
+
p result
|
|
80
|
+
rescue RelentlessIdentity::ApiError => e
|
|
81
|
+
puts "Exception when calling AccountApi->get_request_history: #{e}"
|
|
82
|
+
end
|
|
83
|
+
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## Documentation for API Endpoints
|
|
87
|
+
|
|
88
|
+
All URIs are relative to *https://api.relentlessidentity.com*
|
|
89
|
+
|
|
90
|
+
Class | Method | HTTP request | Description
|
|
91
|
+
------------ | ------------- | ------------- | -------------
|
|
92
|
+
*RelentlessIdentity::AccountApi* | [**get_request_history**](docs/AccountApi.md#get_request_history) | **GET** /client/history | Get paginated request history
|
|
93
|
+
*RelentlessIdentity::AccountApi* | [**get_token_status**](docs/AccountApi.md#get_token_status) | **GET** /client/token | Inspect the current bearer token
|
|
94
|
+
*RelentlessIdentity::AccountApi* | [**get_usage**](docs/AccountApi.md#get_usage) | **GET** /client/usage | Get current usage and limits
|
|
95
|
+
*RelentlessIdentity::FinderApi* | [**finder_attempt**](docs/FinderApi.md#finder_attempt) | **POST** /client/attempt | Find a work email
|
|
96
|
+
*RelentlessIdentity::JobsApi* | [**get_job**](docs/JobsApi.md#get_job) | **GET** /client/jobs/{job_id} | Get background job
|
|
97
|
+
*RelentlessIdentity::JobsApi* | [**get_job_inputs_text**](docs/JobsApi.md#get_job_inputs_text) | **GET** /client/jobs/{job_id}/inputs.txt | Download job inputs
|
|
98
|
+
*RelentlessIdentity::JobsApi* | [**get_job_results_json**](docs/JobsApi.md#get_job_results_json) | **GET** /client/jobs/{job_id}/results.json | Download job results as JSON
|
|
99
|
+
*RelentlessIdentity::JobsApi* | [**get_job_results_text**](docs/JobsApi.md#get_job_results_text) | **GET** /client/jobs/{job_id}/results.txt | Download job results as text
|
|
100
|
+
*RelentlessIdentity::JobsApi* | [**list_jobs**](docs/JobsApi.md#list_jobs) | **GET** /client/jobs | List background jobs
|
|
101
|
+
*RelentlessIdentity::JobsApi* | [**schedule_finder_batch**](docs/JobsApi.md#schedule_finder_batch) | **POST** /client/jobs/finder | Schedule a finder batch
|
|
102
|
+
*RelentlessIdentity::JobsApi* | [**schedule_probe_batch**](docs/JobsApi.md#schedule_probe_batch) | **POST** /client/jobs/probe-batch | Schedule a probe batch
|
|
103
|
+
*RelentlessIdentity::ProbeApi* | [**probe_batch**](docs/ProbeApi.md#probe_batch) | **POST** /client/probe/batch | Verify many email addresses
|
|
104
|
+
*RelentlessIdentity::ProbeApi* | [**probe_email**](docs/ProbeApi.md#probe_email) | **POST** /client/probe | Verify an email address
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
## Documentation for Models
|
|
108
|
+
|
|
109
|
+
- [RelentlessIdentity::AliasInfo](docs/AliasInfo.md)
|
|
110
|
+
- [RelentlessIdentity::BatchSummary](docs/BatchSummary.md)
|
|
111
|
+
- [RelentlessIdentity::ClientBackgroundJobDetailResponse](docs/ClientBackgroundJobDetailResponse.md)
|
|
112
|
+
- [RelentlessIdentity::ClientBackgroundJobItemResponse](docs/ClientBackgroundJobItemResponse.md)
|
|
113
|
+
- [RelentlessIdentity::ClientBackgroundJobPageResponse](docs/ClientBackgroundJobPageResponse.md)
|
|
114
|
+
- [RelentlessIdentity::ClientBackgroundJobResponse](docs/ClientBackgroundJobResponse.md)
|
|
115
|
+
- [RelentlessIdentity::ClientBatchIdentityResponse](docs/ClientBatchIdentityResponse.md)
|
|
116
|
+
- [RelentlessIdentity::ClientFinderResponse](docs/ClientFinderResponse.md)
|
|
117
|
+
- [RelentlessIdentity::ClientFinderResponseAlias](docs/ClientFinderResponseAlias.md)
|
|
118
|
+
- [RelentlessIdentity::ClientIdentityResponse](docs/ClientIdentityResponse.md)
|
|
119
|
+
- [RelentlessIdentity::ClientRequestHistoryItem](docs/ClientRequestHistoryItem.md)
|
|
120
|
+
- [RelentlessIdentity::ClientRequestHistoryPageResponse](docs/ClientRequestHistoryPageResponse.md)
|
|
121
|
+
- [RelentlessIdentity::ClientTokenStatusResponse](docs/ClientTokenStatusResponse.md)
|
|
122
|
+
- [RelentlessIdentity::ClientUsageResponse](docs/ClientUsageResponse.md)
|
|
123
|
+
- [RelentlessIdentity::ErrorResponse](docs/ErrorResponse.md)
|
|
124
|
+
- [RelentlessIdentity::FinderBatchJobRequest](docs/FinderBatchJobRequest.md)
|
|
125
|
+
- [RelentlessIdentity::FinderBatchJobRequestInputsInner](docs/FinderBatchJobRequestInputsInner.md)
|
|
126
|
+
- [RelentlessIdentity::FinderRequest](docs/FinderRequest.md)
|
|
127
|
+
- [RelentlessIdentity::HTTPValidationError](docs/HTTPValidationError.md)
|
|
128
|
+
- [RelentlessIdentity::IdentityProvider](docs/IdentityProvider.md)
|
|
129
|
+
- [RelentlessIdentity::LocationInner](docs/LocationInner.md)
|
|
130
|
+
- [RelentlessIdentity::ProbeBatchJobBackgroundRequest](docs/ProbeBatchJobBackgroundRequest.md)
|
|
131
|
+
- [RelentlessIdentity::ProbeBatchRequest](docs/ProbeBatchRequest.md)
|
|
132
|
+
- [RelentlessIdentity::ProbeRequest](docs/ProbeRequest.md)
|
|
133
|
+
- [RelentlessIdentity::ValidationError](docs/ValidationError.md)
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
## Documentation for Authorization
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
Authentication schemes defined for the API:
|
|
140
|
+
### bearerAuth
|
|
141
|
+
|
|
142
|
+
- **Type**: Bearer authentication (PAT)
|
|
143
|
+
|
data/Rakefile
ADDED
data/docs/AccountApi.md
ADDED
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
# RelentlessIdentity::AccountApi
|
|
2
|
+
|
|
3
|
+
All URIs are relative to *https://api.relentlessidentity.com*
|
|
4
|
+
|
|
5
|
+
| Method | HTTP request | Description |
|
|
6
|
+
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**get_request_history**](AccountApi.md#get_request_history) | **GET** /client/history | Get paginated request history |
|
|
8
|
+
| [**get_token_status**](AccountApi.md#get_token_status) | **GET** /client/token | Inspect the current bearer token |
|
|
9
|
+
| [**get_usage**](AccountApi.md#get_usage) | **GET** /client/usage | Get current usage and limits |
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## get_request_history
|
|
13
|
+
|
|
14
|
+
> <ClientRequestHistoryPageResponse> get_request_history(opts)
|
|
15
|
+
|
|
16
|
+
Get paginated request history
|
|
17
|
+
|
|
18
|
+
Return the authenticated user's latest request history with pagination and optional filters.
|
|
19
|
+
|
|
20
|
+
### Examples
|
|
21
|
+
|
|
22
|
+
```ruby
|
|
23
|
+
require 'time'
|
|
24
|
+
require 'relentless_identity'
|
|
25
|
+
# setup authorization
|
|
26
|
+
RelentlessIdentity.configure do |config|
|
|
27
|
+
# Configure Bearer authorization (PAT): bearerAuth
|
|
28
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
29
|
+
end
|
|
30
|
+
|
|
31
|
+
api_instance = RelentlessIdentity::AccountApi.new
|
|
32
|
+
opts = {
|
|
33
|
+
page: 56, # Integer | Page number starting at 1.
|
|
34
|
+
page_size: 56, # Integer | Number of history rows per page. Maximum 25.
|
|
35
|
+
request_type: 'finder', # String | Optional request-type filter.
|
|
36
|
+
state: 'deliverable' # String | Optional deliverability-state filter.
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
begin
|
|
40
|
+
# Get paginated request history
|
|
41
|
+
result = api_instance.get_request_history(opts)
|
|
42
|
+
p result
|
|
43
|
+
rescue RelentlessIdentity::ApiError => e
|
|
44
|
+
puts "Error when calling AccountApi->get_request_history: #{e}"
|
|
45
|
+
end
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
#### Using the get_request_history_with_http_info variant
|
|
49
|
+
|
|
50
|
+
This returns an Array which contains the response data, status code and headers.
|
|
51
|
+
|
|
52
|
+
> <Array(<ClientRequestHistoryPageResponse>, Integer, Hash)> get_request_history_with_http_info(opts)
|
|
53
|
+
|
|
54
|
+
```ruby
|
|
55
|
+
begin
|
|
56
|
+
# Get paginated request history
|
|
57
|
+
data, status_code, headers = api_instance.get_request_history_with_http_info(opts)
|
|
58
|
+
p status_code # => 2xx
|
|
59
|
+
p headers # => { ... }
|
|
60
|
+
p data # => <ClientRequestHistoryPageResponse>
|
|
61
|
+
rescue RelentlessIdentity::ApiError => e
|
|
62
|
+
puts "Error when calling AccountApi->get_request_history_with_http_info: #{e}"
|
|
63
|
+
end
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Parameters
|
|
67
|
+
|
|
68
|
+
| Name | Type | Description | Notes |
|
|
69
|
+
| ---- | ---- | ----------- | ----- |
|
|
70
|
+
| **page** | **Integer** | Page number starting at 1. | [optional][default to 1] |
|
|
71
|
+
| **page_size** | **Integer** | Number of history rows per page. Maximum 25. | [optional][default to 25] |
|
|
72
|
+
| **request_type** | **String** | Optional request-type filter. | [optional] |
|
|
73
|
+
| **state** | **String** | Optional deliverability-state filter. | [optional] |
|
|
74
|
+
|
|
75
|
+
### Return type
|
|
76
|
+
|
|
77
|
+
[**ClientRequestHistoryPageResponse**](ClientRequestHistoryPageResponse.md)
|
|
78
|
+
|
|
79
|
+
### Authorization
|
|
80
|
+
|
|
81
|
+
[bearerAuth](../README.md#bearerAuth)
|
|
82
|
+
|
|
83
|
+
### HTTP request headers
|
|
84
|
+
|
|
85
|
+
- **Content-Type**: Not defined
|
|
86
|
+
- **Accept**: application/json
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
## get_token_status
|
|
90
|
+
|
|
91
|
+
> <ClientTokenStatusResponse> get_token_status
|
|
92
|
+
|
|
93
|
+
Inspect the current bearer token
|
|
94
|
+
|
|
95
|
+
Validate the current bearer token and return its active claims.
|
|
96
|
+
|
|
97
|
+
### Examples
|
|
98
|
+
|
|
99
|
+
```ruby
|
|
100
|
+
require 'time'
|
|
101
|
+
require 'relentless_identity'
|
|
102
|
+
# setup authorization
|
|
103
|
+
RelentlessIdentity.configure do |config|
|
|
104
|
+
# Configure Bearer authorization (PAT): bearerAuth
|
|
105
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
106
|
+
end
|
|
107
|
+
|
|
108
|
+
api_instance = RelentlessIdentity::AccountApi.new
|
|
109
|
+
|
|
110
|
+
begin
|
|
111
|
+
# Inspect the current bearer token
|
|
112
|
+
result = api_instance.get_token_status
|
|
113
|
+
p result
|
|
114
|
+
rescue RelentlessIdentity::ApiError => e
|
|
115
|
+
puts "Error when calling AccountApi->get_token_status: #{e}"
|
|
116
|
+
end
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
#### Using the get_token_status_with_http_info variant
|
|
120
|
+
|
|
121
|
+
This returns an Array which contains the response data, status code and headers.
|
|
122
|
+
|
|
123
|
+
> <Array(<ClientTokenStatusResponse>, Integer, Hash)> get_token_status_with_http_info
|
|
124
|
+
|
|
125
|
+
```ruby
|
|
126
|
+
begin
|
|
127
|
+
# Inspect the current bearer token
|
|
128
|
+
data, status_code, headers = api_instance.get_token_status_with_http_info
|
|
129
|
+
p status_code # => 2xx
|
|
130
|
+
p headers # => { ... }
|
|
131
|
+
p data # => <ClientTokenStatusResponse>
|
|
132
|
+
rescue RelentlessIdentity::ApiError => e
|
|
133
|
+
puts "Error when calling AccountApi->get_token_status_with_http_info: #{e}"
|
|
134
|
+
end
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### Parameters
|
|
138
|
+
|
|
139
|
+
This endpoint does not need any parameter.
|
|
140
|
+
|
|
141
|
+
### Return type
|
|
142
|
+
|
|
143
|
+
[**ClientTokenStatusResponse**](ClientTokenStatusResponse.md)
|
|
144
|
+
|
|
145
|
+
### Authorization
|
|
146
|
+
|
|
147
|
+
[bearerAuth](../README.md#bearerAuth)
|
|
148
|
+
|
|
149
|
+
### HTTP request headers
|
|
150
|
+
|
|
151
|
+
- **Content-Type**: Not defined
|
|
152
|
+
- **Accept**: application/json
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
## get_usage
|
|
156
|
+
|
|
157
|
+
> <ClientUsageResponse> get_usage
|
|
158
|
+
|
|
159
|
+
Get current usage and limits
|
|
160
|
+
|
|
161
|
+
Return the current account usage, free-tier limits, and paid capacity details for the authenticated user.
|
|
162
|
+
|
|
163
|
+
### Examples
|
|
164
|
+
|
|
165
|
+
```ruby
|
|
166
|
+
require 'time'
|
|
167
|
+
require 'relentless_identity'
|
|
168
|
+
# setup authorization
|
|
169
|
+
RelentlessIdentity.configure do |config|
|
|
170
|
+
# Configure Bearer authorization (PAT): bearerAuth
|
|
171
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
172
|
+
end
|
|
173
|
+
|
|
174
|
+
api_instance = RelentlessIdentity::AccountApi.new
|
|
175
|
+
|
|
176
|
+
begin
|
|
177
|
+
# Get current usage and limits
|
|
178
|
+
result = api_instance.get_usage
|
|
179
|
+
p result
|
|
180
|
+
rescue RelentlessIdentity::ApiError => e
|
|
181
|
+
puts "Error when calling AccountApi->get_usage: #{e}"
|
|
182
|
+
end
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
#### Using the get_usage_with_http_info variant
|
|
186
|
+
|
|
187
|
+
This returns an Array which contains the response data, status code and headers.
|
|
188
|
+
|
|
189
|
+
> <Array(<ClientUsageResponse>, Integer, Hash)> get_usage_with_http_info
|
|
190
|
+
|
|
191
|
+
```ruby
|
|
192
|
+
begin
|
|
193
|
+
# Get current usage and limits
|
|
194
|
+
data, status_code, headers = api_instance.get_usage_with_http_info
|
|
195
|
+
p status_code # => 2xx
|
|
196
|
+
p headers # => { ... }
|
|
197
|
+
p data # => <ClientUsageResponse>
|
|
198
|
+
rescue RelentlessIdentity::ApiError => e
|
|
199
|
+
puts "Error when calling AccountApi->get_usage_with_http_info: #{e}"
|
|
200
|
+
end
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Parameters
|
|
204
|
+
|
|
205
|
+
This endpoint does not need any parameter.
|
|
206
|
+
|
|
207
|
+
### Return type
|
|
208
|
+
|
|
209
|
+
[**ClientUsageResponse**](ClientUsageResponse.md)
|
|
210
|
+
|
|
211
|
+
### Authorization
|
|
212
|
+
|
|
213
|
+
[bearerAuth](../README.md#bearerAuth)
|
|
214
|
+
|
|
215
|
+
### HTTP request headers
|
|
216
|
+
|
|
217
|
+
- **Content-Type**: Not defined
|
|
218
|
+
- **Accept**: application/json
|
|
219
|
+
|
data/docs/AliasInfo.md
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# RelentlessIdentity::AliasInfo
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **original** | **String** | | [optional] |
|
|
8
|
+
| **resolved** | **String** | | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'relentless_identity'
|
|
14
|
+
|
|
15
|
+
instance = RelentlessIdentity::AliasInfo.new(
|
|
16
|
+
original: null,
|
|
17
|
+
resolved: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# RelentlessIdentity::BatchSummary
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **total** | **Integer** | Total number of requested items. | |
|
|
8
|
+
| **found** | **Integer** | Items that resolved to a positive deliverable result. | |
|
|
9
|
+
| **not_found** | **Integer** | Items that completed cleanly with a negative result. | |
|
|
10
|
+
| **errors** | **Integer** | Items that ended with an operational verification error rather than a mailbox verdict. | |
|
|
11
|
+
| **unique_domains** | **Integer** | Distinct mailbox domains represented in the batch. | |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'relentless_identity'
|
|
17
|
+
|
|
18
|
+
instance = RelentlessIdentity::BatchSummary.new(
|
|
19
|
+
total: null,
|
|
20
|
+
found: null,
|
|
21
|
+
not_found: null,
|
|
22
|
+
errors: null,
|
|
23
|
+
unique_domains: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientBackgroundJobDetailResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **job** | [**ClientBackgroundJobResponse**](ClientBackgroundJobResponse.md) | | |
|
|
8
|
+
| **items** | [**Array<ClientBackgroundJobItemResponse>**](ClientBackgroundJobItemResponse.md) | | |
|
|
9
|
+
| **total_items** | **Integer** | | |
|
|
10
|
+
| **page** | **Integer** | | |
|
|
11
|
+
| **page_size** | **Integer** | | |
|
|
12
|
+
| **total_pages** | **Integer** | | |
|
|
13
|
+
| **results_expired** | **Boolean** | Whether the stored item payload rows have already expired and been pruned. | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'relentless_identity'
|
|
19
|
+
|
|
20
|
+
instance = RelentlessIdentity::ClientBackgroundJobDetailResponse.new(
|
|
21
|
+
job: null,
|
|
22
|
+
items: null,
|
|
23
|
+
total_items: null,
|
|
24
|
+
page: null,
|
|
25
|
+
page_size: null,
|
|
26
|
+
total_pages: null,
|
|
27
|
+
results_expired: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientBackgroundJobItemResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **id** | **String** | | |
|
|
8
|
+
| **item_index** | **Integer** | | |
|
|
9
|
+
| **status** | **String** | | |
|
|
10
|
+
| **request_type** | **String** | | |
|
|
11
|
+
| **input** | **Hash<String, Object>** | Original submitted input for this item. | |
|
|
12
|
+
| **result** | **Hash<String, Object>** | | [optional] |
|
|
13
|
+
| **result_state** | **String** | | [optional] |
|
|
14
|
+
| **result_outcome** | **String** | | [optional] |
|
|
15
|
+
| **resolved_address** | **String** | | [optional] |
|
|
16
|
+
| **provider** | **String** | | [optional] |
|
|
17
|
+
| **charge_micros** | **Integer** | | [optional][default to 0] |
|
|
18
|
+
| **error_message** | **String** | | [optional] |
|
|
19
|
+
| **started_at** | **Time** | | [optional] |
|
|
20
|
+
| **completed_at** | **Time** | | [optional] |
|
|
21
|
+
| **created_at** | **Time** | | |
|
|
22
|
+
| **updated_at** | **Time** | | |
|
|
23
|
+
|
|
24
|
+
## Example
|
|
25
|
+
|
|
26
|
+
```ruby
|
|
27
|
+
require 'relentless_identity'
|
|
28
|
+
|
|
29
|
+
instance = RelentlessIdentity::ClientBackgroundJobItemResponse.new(
|
|
30
|
+
id: null,
|
|
31
|
+
item_index: null,
|
|
32
|
+
status: null,
|
|
33
|
+
request_type: null,
|
|
34
|
+
input: null,
|
|
35
|
+
result: null,
|
|
36
|
+
result_state: null,
|
|
37
|
+
result_outcome: null,
|
|
38
|
+
resolved_address: null,
|
|
39
|
+
provider: null,
|
|
40
|
+
charge_micros: null,
|
|
41
|
+
error_message: null,
|
|
42
|
+
started_at: null,
|
|
43
|
+
completed_at: null,
|
|
44
|
+
created_at: null,
|
|
45
|
+
updated_at: null
|
|
46
|
+
)
|
|
47
|
+
```
|
|
48
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientBackgroundJobPageResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **items** | [**Array<ClientBackgroundJobResponse>**](ClientBackgroundJobResponse.md) | | |
|
|
8
|
+
| **total** | **Integer** | | |
|
|
9
|
+
| **page** | **Integer** | | |
|
|
10
|
+
| **page_size** | **Integer** | | |
|
|
11
|
+
| **total_pages** | **Integer** | | |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'relentless_identity'
|
|
17
|
+
|
|
18
|
+
instance = RelentlessIdentity::ClientBackgroundJobPageResponse.new(
|
|
19
|
+
items: null,
|
|
20
|
+
total: null,
|
|
21
|
+
page: null,
|
|
22
|
+
page_size: null,
|
|
23
|
+
total_pages: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientBackgroundJobResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **id** | **String** | | |
|
|
8
|
+
| **job_type** | **String** | | |
|
|
9
|
+
| **status** | **String** | Current high-level job lifecycle state. | |
|
|
10
|
+
| **deadline_at** | **Time** | | |
|
|
11
|
+
| **estimated_runtime_seconds** | **Integer** | | |
|
|
12
|
+
| **scheduled_start_at** | **Time** | | |
|
|
13
|
+
| **callback_url** | **String** | | [optional] |
|
|
14
|
+
| **callback_status** | **String** | | |
|
|
15
|
+
| **callback_attempts** | **Integer** | | |
|
|
16
|
+
| **callback_last_error** | **String** | | [optional] |
|
|
17
|
+
| **requested_count** | **Integer** | Total number of submitted items for the job. | |
|
|
18
|
+
| **completed_count** | **Integer** | | |
|
|
19
|
+
| **success_count** | **Integer** | | |
|
|
20
|
+
| **not_found_count** | **Integer** | | |
|
|
21
|
+
| **error_count** | **Integer** | | |
|
|
22
|
+
| **reserved_amount_micros** | **Integer** | | |
|
|
23
|
+
| **actual_amount_micros** | **Integer** | | |
|
|
24
|
+
| **progress_percent** | **Float** | Approximate percent complete based on completed item count. | [optional] |
|
|
25
|
+
| **summary** | **Hash<String, Object>** | Aggregated counts and provider stats for the job. | [optional] |
|
|
26
|
+
| **metadata** | **Hash<String, Object>** | | [optional] |
|
|
27
|
+
| **started_at** | **Time** | | [optional] |
|
|
28
|
+
| **completed_at** | **Time** | | [optional] |
|
|
29
|
+
| **history_expires_at** | **Time** | | [optional] |
|
|
30
|
+
| **results_pruned_at** | **Time** | | [optional] |
|
|
31
|
+
| **artifact_available** | **Boolean** | | [optional][default to false] |
|
|
32
|
+
| **artifact_json_url** | **String** | | [optional] |
|
|
33
|
+
| **artifact_size_bytes** | **Integer** | | [optional] |
|
|
34
|
+
| **artifact_uploaded_at** | **Time** | | [optional] |
|
|
35
|
+
| **created_at** | **Time** | | |
|
|
36
|
+
| **updated_at** | **Time** | | |
|
|
37
|
+
|
|
38
|
+
## Example
|
|
39
|
+
|
|
40
|
+
```ruby
|
|
41
|
+
require 'relentless_identity'
|
|
42
|
+
|
|
43
|
+
instance = RelentlessIdentity::ClientBackgroundJobResponse.new(
|
|
44
|
+
id: null,
|
|
45
|
+
job_type: null,
|
|
46
|
+
status: null,
|
|
47
|
+
deadline_at: null,
|
|
48
|
+
estimated_runtime_seconds: null,
|
|
49
|
+
scheduled_start_at: null,
|
|
50
|
+
callback_url: null,
|
|
51
|
+
callback_status: null,
|
|
52
|
+
callback_attempts: null,
|
|
53
|
+
callback_last_error: null,
|
|
54
|
+
requested_count: null,
|
|
55
|
+
completed_count: null,
|
|
56
|
+
success_count: null,
|
|
57
|
+
not_found_count: null,
|
|
58
|
+
error_count: null,
|
|
59
|
+
reserved_amount_micros: null,
|
|
60
|
+
actual_amount_micros: null,
|
|
61
|
+
progress_percent: null,
|
|
62
|
+
summary: null,
|
|
63
|
+
metadata: null,
|
|
64
|
+
started_at: null,
|
|
65
|
+
completed_at: null,
|
|
66
|
+
history_expires_at: null,
|
|
67
|
+
results_pruned_at: null,
|
|
68
|
+
artifact_available: null,
|
|
69
|
+
artifact_json_url: null,
|
|
70
|
+
artifact_size_bytes: null,
|
|
71
|
+
artifact_uploaded_at: null,
|
|
72
|
+
created_at: null,
|
|
73
|
+
updated_at: null
|
|
74
|
+
)
|
|
75
|
+
```
|
|
76
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientBatchIdentityResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **results** | [**Array<ClientIdentityResponse>**](ClientIdentityResponse.md) | Per-email compact probe results in request order. | |
|
|
8
|
+
| **summary** | [**BatchSummary**](BatchSummary.md) | | |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'relentless_identity'
|
|
14
|
+
|
|
15
|
+
instance = RelentlessIdentity::ClientBatchIdentityResponse.new(
|
|
16
|
+
results: null,
|
|
17
|
+
summary: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# RelentlessIdentity::ClientFinderResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **state** | **String** | Final public deliverability verdict. | |
|
|
8
|
+
| **outcome** | **String** | Operational outcome. `error` means the verification could not complete cleanly and should not be treated as a negative mailbox verdict. | [optional] |
|
|
9
|
+
| **address** | **String** | | [optional] |
|
|
10
|
+
| **is_alias** | **Boolean** | Whether the resolved address is an alias rather than a primary mailbox. | [optional] |
|
|
11
|
+
| **_alias** | [**ClientFinderResponseAlias**](ClientFinderResponseAlias.md) | | [optional] |
|
|
12
|
+
| **is_catchall** | **Boolean** | Whether the mailbox domain behaved like a catch-all during verification. | [optional] |
|
|
13
|
+
| **identity_providers** | [**Array<IdentityProvider>**](IdentityProvider.md) | Identity providers associated with the mailbox domain when available. | [optional] |
|
|
14
|
+
| **mx_hosts** | **Array<String>** | Observed MX hosts for the mailbox domain. | [optional] |
|
|
15
|
+
| **request_id** | **String** | | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'relentless_identity'
|
|
21
|
+
|
|
22
|
+
instance = RelentlessIdentity::ClientFinderResponse.new(
|
|
23
|
+
state: null,
|
|
24
|
+
outcome: null,
|
|
25
|
+
address: null,
|
|
26
|
+
is_alias: null,
|
|
27
|
+
_alias: null,
|
|
28
|
+
is_catchall: null,
|
|
29
|
+
identity_providers: null,
|
|
30
|
+
mx_hosts: null,
|
|
31
|
+
request_id: null
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|