docs/TransactionalEmailsApi.md in sib-api-v3-sdk-7.1.0 vs docs/TransactionalEmailsApi.md in sib-api-v3-sdk-7.2.0

- old
+ new

@@ -2,14 +2,17 @@ All URIs are relative to *https://api.sendinblue.com/v3* Method | HTTP request | Description ------------- | ------------- | ------------- +[**block_new_domain**](TransactionalEmailsApi.md#block_new_domain) | **POST** /smtp/blockedDomains | Add a new domain to the list of blocked domains [**create_smtp_template**](TransactionalEmailsApi.md#create_smtp_template) | **POST** /smtp/templates | Create an email template +[**delete_blocked_domain**](TransactionalEmailsApi.md#delete_blocked_domain) | **DELETE** /smtp/blockedDomains/{domain} | Unblock an existing domain from the list of blocked domains [**delete_hardbounces**](TransactionalEmailsApi.md#delete_hardbounces) | **POST** /smtp/deleteHardbounces | Delete hardbounces [**delete_smtp_template**](TransactionalEmailsApi.md#delete_smtp_template) | **DELETE** /smtp/templates/{templateId} | Delete an inactive email template [**get_aggregated_smtp_report**](TransactionalEmailsApi.md#get_aggregated_smtp_report) | **GET** /smtp/statistics/aggregatedReport | Get your transactional email activity aggregated over a period of time +[**get_blocked_domains**](TransactionalEmailsApi.md#get_blocked_domains) | **GET** /smtp/blockedDomains | Get the list of blocked domains [**get_email_event_report**](TransactionalEmailsApi.md#get_email_event_report) | **GET** /smtp/statistics/events | Get all your transactional email activity (unaggregated events) [**get_smtp_report**](TransactionalEmailsApi.md#get_smtp_report) | **GET** /smtp/statistics/reports | Get your transactional email activity aggregated per day [**get_smtp_template**](TransactionalEmailsApi.md#get_smtp_template) | **GET** /smtp/templates/{templateId} | Returns the template information [**get_smtp_templates**](TransactionalEmailsApi.md#get_smtp_templates) | **GET** /smtp/templates | Get the list of email templates [**get_transac_blocked_contacts**](TransactionalEmailsApi.md#get_transac_blocked_contacts) | **GET** /smtp/blockedContacts | Get the list of blocked or unsubscribed transactional contacts @@ -21,10 +24,68 @@ [**smtp_blocked_contacts_email_delete**](TransactionalEmailsApi.md#smtp_blocked_contacts_email_delete) | **DELETE** /smtp/blockedContacts/{email} | Unblock or resubscribe a transactional contact [**smtp_log_message_id_delete**](TransactionalEmailsApi.md#smtp_log_message_id_delete) | **DELETE** /smtp/log/{messageId} | Delete an SMTP transactional log [**update_smtp_template**](TransactionalEmailsApi.md#update_smtp_template) | **PUT** /smtp/templates/{templateId} | Update an email template +# **block_new_domain** +> block_new_domain(block_domain) + +Add a new domain to the list of blocked domains + +Blocks a new domain in order to avoid messages being sent to the same + +### Example +```ruby +# load the gem +require 'sib-api-v3-sdk' +# setup authorization +SibApiV3Sdk.configure do |config| + # Configure API key authorization: api-key + config.api_key['api-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['api-key'] = 'Bearer' + + # Configure API key authorization: partner-key + config.api_key['partner-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['partner-key'] = 'Bearer' +end + +api_instance = SibApiV3Sdk::TransactionalEmailsApi.new + +block_domain = SibApiV3Sdk::BlockDomain.new # BlockDomain | + + +begin + #Add a new domain to the list of blocked domains + api_instance.block_new_domain(block_domain) +rescue SibApiV3Sdk::ApiError => e + puts "Exception when calling TransactionalEmailsApi->block_new_domain: #{e}" +end +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **block_domain** | [**BlockDomain**](BlockDomain.md)| | + +### Return type + +nil (empty response body) + +### Authorization + +[api-key](../README.md#api-key), [partner-key](../README.md#partner-key) + +### HTTP request headers + + - **Content-Type**: application/json + - **Accept**: application/json + + + # **create_smtp_template** > CreateModel create_smtp_template(smtp_template) Create an email template @@ -78,10 +139,68 @@ - **Content-Type**: application/json - **Accept**: application/json +# **delete_blocked_domain** +> delete_blocked_domain(domain) + +Unblock an existing domain from the list of blocked domains + +Unblocks an existing domain from the list of blocked domains + +### Example +```ruby +# load the gem +require 'sib-api-v3-sdk' +# setup authorization +SibApiV3Sdk.configure do |config| + # Configure API key authorization: api-key + config.api_key['api-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['api-key'] = 'Bearer' + + # Configure API key authorization: partner-key + config.api_key['partner-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['partner-key'] = 'Bearer' +end + +api_instance = SibApiV3Sdk::TransactionalEmailsApi.new + +domain = 'domain_example' # String | The name of the domain to be deleted + + +begin + #Unblock an existing domain from the list of blocked domains + api_instance.delete_blocked_domain(domain) +rescue SibApiV3Sdk::ApiError => e + puts "Exception when calling TransactionalEmailsApi->delete_blocked_domain: #{e}" +end +``` + +### Parameters + +Name | Type | Description | Notes +------------- | ------------- | ------------- | ------------- + **domain** | **String**| The name of the domain to be deleted | + +### Return type + +nil (empty response body) + +### Authorization + +[api-key](../README.md#api-key), [partner-key](../README.md#partner-key) + +### HTTP request headers + + - **Content-Type**: application/json + - **Accept**: application/json + + + # **delete_hardbounces** > delete_hardbounces(opts) Delete hardbounces @@ -257,10 +376,63 @@ - **Content-Type**: application/json - **Accept**: application/json +# **get_blocked_domains** +> GetBlockedDomains get_blocked_domains + +Get the list of blocked domains + +Get the list of blocked domains + +### Example +```ruby +# load the gem +require 'sib-api-v3-sdk' +# setup authorization +SibApiV3Sdk.configure do |config| + # Configure API key authorization: api-key + config.api_key['api-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['api-key'] = 'Bearer' + + # Configure API key authorization: partner-key + config.api_key['partner-key'] = 'YOUR API KEY' + # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil) + #config.api_key_prefix['partner-key'] = 'Bearer' +end + +api_instance = SibApiV3Sdk::TransactionalEmailsApi.new + +begin + #Get the list of blocked domains + result = api_instance.get_blocked_domains + p result +rescue SibApiV3Sdk::ApiError => e + puts "Exception when calling TransactionalEmailsApi->get_blocked_domains: #{e}" +end +``` + +### Parameters +This endpoint does not need any parameter. + +### Return type + +[**GetBlockedDomains**](GetBlockedDomains.md) + +### Authorization + +[api-key](../README.md#api-key), [partner-key](../README.md#partner-key) + +### HTTP request headers + + - **Content-Type**: application/json + - **Accept**: application/json + + + # **get_email_event_report** > GetEmailEventReport get_email_event_report(opts) Get all your transactional email activity (unaggregated events) @@ -291,11 +463,12 @@ days: 56, # Integer | Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate' email: 'email_example', # String | Filter the report for a specific email addresses event: 'event_example', # String | Filter the report for a specific event type tags: 'tags_example', # String | Filter the report for tags (serialized and urlencoded array) message_id: 'message_id_example', # String | Filter on a specific message id - template_id: 789 # Integer | Filter on a specific template id + template_id: 789, # Integer | Filter on a specific template id + sort: 'desc' # String | Sort the results in the ascending/descending order of record creation } begin #Get all your transactional email activity (unaggregated events) result = api_instance.get_email_event_report(opts) @@ -317,10 +490,11 @@ **email** | **String**| Filter the report for a specific email addresses | [optional] **event** | **String**| Filter the report for a specific event type | [optional] **tags** | **String**| Filter the report for tags (serialized and urlencoded array) | [optional] **message_id** | **String**| Filter on a specific message id | [optional] **template_id** | **Integer**| Filter on a specific template id | [optional] + **sort** | **String**| Sort the results in the ascending/descending order of record creation | [optional] [default to desc] ### Return type [**GetEmailEventReport**](GetEmailEventReport.md) @@ -363,11 +537,12 @@ limit: 10, # Integer | Number of documents returned per page offset: 0, # Integer | Index of the first document on the page start_date: 'start_date_example', # String | Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD) end_date: 'end_date_example', # String | Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD) days: 56, # Integer | Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate' - tag: 'tag_example' # String | Tag of the emails + tag: 'tag_example', # String | Tag of the emails + sort: 'desc' # String | Sort the results in the ascending/descending order of record creation } begin #Get your transactional email activity aggregated per day result = api_instance.get_smtp_report(opts) @@ -385,10 +560,11 @@ **offset** | **Integer**| Index of the first document on the page | [optional] [default to 0] **start_date** | **String**| Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD) | [optional] **end_date** | **String**| Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD) | [optional] **days** | **Integer**| Number of days in the past including today (positive integer). Not compatible with &#39;startDate&#39; and &#39;endDate&#39; | [optional] **tag** | **String**| Tag of the emails | [optional] + **sort** | **String**| Sort the results in the ascending/descending order of record creation | [optional] [default to desc] ### Return type [**GetReports**](GetReports.md) @@ -485,11 +661,12 @@ api_instance = SibApiV3Sdk::TransactionalEmailsApi.new opts = { template_status: true, # BOOLEAN | Filter on the status of the template. Active = true, inactive = false limit: 50, # Integer | Number of documents returned per page - offset: 0 # Integer | Index of the first document in the page + offset: 0, # Integer | Index of the first document in the page + sort: 'desc' # String | Sort the results in the ascending/descending order of record creation } begin #Get the list of email templates result = api_instance.get_smtp_templates(opts) @@ -504,10 +681,11 @@ Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **template_status** | **BOOLEAN**| Filter on the status of the template. Active &#x3D; true, inactive &#x3D; false | [optional] **limit** | **Integer**| Number of documents returned per page | [optional] [default to 50] **offset** | **Integer**| Index of the first document in the page | [optional] [default to 0] + **sort** | **String**| Sort the results in the ascending/descending order of record creation | [optional] [default to desc] ### Return type [**GetSmtpTemplates**](GetSmtpTemplates.md) @@ -549,11 +727,12 @@ opts = { start_date: 'start_date_example', # String | Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the blocked or unsubscribed contacts end_date: 'end_date_example', # String | Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the blocked or unsubscribed contacts limit: 50, # Integer | Number of documents returned per page offset: 0, # Integer | Index of the first document on the page - senders: ['senders_example'] # Array<String> | Comma separated list of emails of the senders from which contacts are blocked or unsubscribed + senders: ['senders_example'], # Array<String> | Comma separated list of emails of the senders from which contacts are blocked or unsubscribed + sort: 'desc' # String | Sort the results in the ascending/descending order of record creation } begin #Get the list of blocked or unsubscribed transactional contacts result = api_instance.get_transac_blocked_contacts(opts) @@ -570,10 +749,11 @@ **start_date** | **String**| Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the blocked or unsubscribed contacts | [optional] **end_date** | **String**| Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the blocked or unsubscribed contacts | [optional] **limit** | **Integer**| Number of documents returned per page | [optional] [default to 50] **offset** | **Integer**| Index of the first document on the page | [optional] [default to 0] **senders** | [**Array&lt;String&gt;**](String.md)| Comma separated list of emails of the senders from which contacts are blocked or unsubscribed | [optional] + **sort** | **String**| Sort the results in the ascending/descending order of record creation | [optional] [default to desc] ### Return type [**GetTransacBlockedContacts**](GetTransacBlockedContacts.md) @@ -674,11 +854,12 @@ opts = { email: 'email_example', # String | Mandatory if templateId and messageId are not passed in query filters. Email address to which transactional email has been sent. template_id: 789, # Integer | Mandatory if email and messageId are not passed in query filters. Id of the template that was used to compose transactional email. message_id: 'message_id_example', # String | Mandatory if templateId and email are not passed in query filters. Message ID of the transactional email sent. start_date: Date.parse('2013-10-20'), # Date | Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Maximum time period that can be selected is one month. - end_date: Date.parse('2013-10-20') # Date | Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month. + end_date: Date.parse('2013-10-20'), # Date | Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month. + sort: 'desc' # String | Sort the results in the ascending/descending order of record creation } begin #Get the list of transactional emails on the basis of allowed filters result = api_instance.get_transac_emails_list(opts) @@ -695,9 +876,10 @@ **email** | **String**| Mandatory if templateId and messageId are not passed in query filters. Email address to which transactional email has been sent. | [optional] **template_id** | **Integer**| Mandatory if email and messageId are not passed in query filters. Id of the template that was used to compose transactional email. | [optional] **message_id** | **String**| Mandatory if templateId and email are not passed in query filters. Message ID of the transactional email sent. | [optional] **start_date** | **Date**| Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Maximum time period that can be selected is one month. | [optional] **end_date** | **Date**| Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month. | [optional] + **sort** | **String**| Sort the results in the ascending/descending order of record creation | [optional] [default to desc] ### Return type [**GetTransacEmailsList**](GetTransacEmailsList.md)