mailslurp_client 8.5.5 → 11.0.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 42b10fba7f56fc8fcf4bf2a3bb77586bb199e9fdb4461192c3346cc4ad224690
4
- data.tar.gz: 389413994d502c09588649c9e5ece25a56cb5fa4a058790c91059e0b47b3566e
3
+ metadata.gz: e5df6d22ba2d40ac2dd06298d8fe6c6c8bc609820d32b5844726c2554315da10
4
+ data.tar.gz: b7c7f99d1a6a5e48966e31a72fc1aed3a920736ab8d561d0e6b4703e9217dec3
5
5
  SHA512:
6
- metadata.gz: 4c358ee8a14324d4065a6c4ea368e6d5dac97435f39e8913375a286ac0fd989b80163fd659ceb8e8cc6ceec8c477563be0f24beaa7624f8043f11b609dd9cdaa
7
- data.tar.gz: 93f145359354718bec5b8ce4c613832659d7c5236dfc36d1135c17810cae9876bbf0557ff2aff3d988d976ce4cd4e6a89a5aaa5d1715ebdc43eb85a6cdda0ac4
6
+ metadata.gz: 3894ac016bb3628a14958d2cf973be12b3e4b3bf73185c6b17b46f8303207039e75e6097a0c3a1792b894ffb038b4ded6c6d9ec0996b084310dcabc199feca8e
7
+ data.tar.gz: 7f38b2f109f313afbaf743da8766adc5c80872928d50efbc3a4a9e5ac6224b3d4157cf07cbc0d771549c9a059589851fd0660093ede2bca5b6a93665915eba18
data/LICENSE CHANGED
@@ -1,4 +1,4 @@
1
- Copyright 2020 MailSlurp Email API (Provided by Pettman OÜ, Estonia)
1
+ Copyright 2021 MailSlurp Email API (Provided by Pettman OÜ, Estonia)
2
2
 
3
3
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4
4
 
@@ -38,6 +38,7 @@ require 'mailslurp_client/models/dns_lookup_results'
38
38
  require 'mailslurp_client/models/describe_domain_options'
39
39
  require 'mailslurp_client/models/describe_mail_server_domain_result'
40
40
  require 'mailslurp_client/models/domain_dto'
41
+ require 'mailslurp_client/models/domain_name_record'
41
42
  require 'mailslurp_client/models/domain_preview'
42
43
  require 'mailslurp_client/models/download_attachment_dto'
43
44
  require 'mailslurp_client/models/email'
@@ -46,6 +47,8 @@ require 'mailslurp_client/models/email_content_match_result'
46
47
  require 'mailslurp_client/models/email_preview'
47
48
  require 'mailslurp_client/models/email_projection'
48
49
  require 'mailslurp_client/models/email_verification_result'
50
+ require 'mailslurp_client/models/expired_inbox_dto'
51
+ require 'mailslurp_client/models/expired_inbox_record_projection'
49
52
  require 'mailslurp_client/models/forward_email_options'
50
53
  require 'mailslurp_client/models/group_contacts_dto'
51
54
  require 'mailslurp_client/models/group_dto'
@@ -62,6 +65,7 @@ require 'mailslurp_client/models/page_alias'
62
65
  require 'mailslurp_client/models/page_contact_projection'
63
66
  require 'mailslurp_client/models/page_email_preview'
64
67
  require 'mailslurp_client/models/page_email_projection'
68
+ require 'mailslurp_client/models/page_expired_inbox_record_projection'
65
69
  require 'mailslurp_client/models/page_group_projection'
66
70
  require 'mailslurp_client/models/page_inbox_projection'
67
71
  require 'mailslurp_client/models/page_sent_email_projection'
@@ -70,6 +74,7 @@ require 'mailslurp_client/models/page_thread_projection'
70
74
  require 'mailslurp_client/models/page_webhook_projection'
71
75
  require 'mailslurp_client/models/pageable'
72
76
  require 'mailslurp_client/models/raw_email_json'
77
+ require 'mailslurp_client/models/reply_to_alias_email_options'
73
78
  require 'mailslurp_client/models/reply_to_email_options'
74
79
  require 'mailslurp_client/models/send_email_options'
75
80
  require 'mailslurp_client/models/sent_email_dto'
@@ -203,6 +203,81 @@ module MailSlurpClient
203
203
  return data, status_code, headers
204
204
  end
205
205
 
206
+ # Get emails for an alias
207
+ # Get paginated emails for an alias by ID
208
+ # @param alias_id [String] aliasId
209
+ # @param [Hash] opts the optional parameters
210
+ # @option opts [Integer] :page Optional page index alias email list pagination (default to 0)
211
+ # @option opts [Integer] :size Optional page size alias email list pagination (default to 20)
212
+ # @option opts [String] :sort Optional createdAt sort direction ASC or DESC (default to 'ASC')
213
+ # @return [PageEmailProjection]
214
+ def get_alias_emails(alias_id, opts = {})
215
+ data, _status_code, _headers = get_alias_emails_with_http_info(alias_id, opts)
216
+ data
217
+ end
218
+
219
+ # Get emails for an alias
220
+ # Get paginated emails for an alias by ID
221
+ # @param alias_id [String] aliasId
222
+ # @param [Hash] opts the optional parameters
223
+ # @option opts [Integer] :page Optional page index alias email list pagination
224
+ # @option opts [Integer] :size Optional page size alias email list pagination
225
+ # @option opts [String] :sort Optional createdAt sort direction ASC or DESC
226
+ # @return [Array<(PageEmailProjection, Integer, Hash)>] PageEmailProjection data, response status code and response headers
227
+ def get_alias_emails_with_http_info(alias_id, opts = {})
228
+ if @api_client.config.debugging
229
+ @api_client.config.logger.debug 'Calling API: AliasControllerApi.get_alias_emails ...'
230
+ end
231
+ # verify the required parameter 'alias_id' is set
232
+ if @api_client.config.client_side_validation && alias_id.nil?
233
+ fail ArgumentError, "Missing the required parameter 'alias_id' when calling AliasControllerApi.get_alias_emails"
234
+ end
235
+ allowable_values = ["ASC", "DESC"]
236
+ if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
237
+ fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
238
+ end
239
+ # resource path
240
+ local_var_path = '/aliases/{aliasId}/emails'.sub('{' + 'aliasId' + '}', CGI.escape(alias_id.to_s))
241
+
242
+ # query parameters
243
+ query_params = opts[:query_params] || {}
244
+ query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
245
+ query_params[:'size'] = opts[:'size'] if !opts[:'size'].nil?
246
+ query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
247
+
248
+ # header parameters
249
+ header_params = opts[:header_params] || {}
250
+ # HTTP header 'Accept' (if needed)
251
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
252
+
253
+ # form parameters
254
+ form_params = opts[:form_params] || {}
255
+
256
+ # http body (model)
257
+ post_body = opts[:body]
258
+
259
+ # return_type
260
+ return_type = opts[:return_type] || 'PageEmailProjection'
261
+
262
+ # auth_names
263
+ auth_names = opts[:auth_names] || ['API_KEY']
264
+
265
+ new_options = opts.merge(
266
+ :header_params => header_params,
267
+ :query_params => query_params,
268
+ :form_params => form_params,
269
+ :body => post_body,
270
+ :auth_names => auth_names,
271
+ :return_type => return_type
272
+ )
273
+
274
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
275
+ if @api_client.config.debugging
276
+ @api_client.config.logger.debug "API called: AliasControllerApi#get_alias_emails\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
277
+ end
278
+ return data, status_code, headers
279
+ end
280
+
206
281
  # Get threads created for an alias
207
282
  # Returns threads created for an email alias in paginated form
208
283
  # @param alias_id [String] aliasId
@@ -347,6 +422,148 @@ module MailSlurpClient
347
422
  return data, status_code, headers
348
423
  end
349
424
 
425
+ # Reply to an email
426
+ # Send the reply to the email sender or reply-to and include same subject cc bcc etc. Reply to an email and the contents will be sent with the existing subject to the emails `to`, `cc`, and `bcc`.
427
+ # @param alias_id [String] ID of the alias that email belongs to
428
+ # @param email_id [String] ID of the email that should be replied to
429
+ # @param reply_to_alias_email_options [ReplyToAliasEmailOptions] replyToAliasEmailOptions
430
+ # @param [Hash] opts the optional parameters
431
+ # @return [SentEmailDto]
432
+ def reply_to_alias_email(alias_id, email_id, reply_to_alias_email_options, opts = {})
433
+ data, _status_code, _headers = reply_to_alias_email_with_http_info(alias_id, email_id, reply_to_alias_email_options, opts)
434
+ data
435
+ end
436
+
437
+ # Reply to an email
438
+ # Send the reply to the email sender or reply-to and include same subject cc bcc etc. Reply to an email and the contents will be sent with the existing subject to the emails &#x60;to&#x60;, &#x60;cc&#x60;, and &#x60;bcc&#x60;.
439
+ # @param alias_id [String] ID of the alias that email belongs to
440
+ # @param email_id [String] ID of the email that should be replied to
441
+ # @param reply_to_alias_email_options [ReplyToAliasEmailOptions] replyToAliasEmailOptions
442
+ # @param [Hash] opts the optional parameters
443
+ # @return [Array<(SentEmailDto, Integer, Hash)>] SentEmailDto data, response status code and response headers
444
+ def reply_to_alias_email_with_http_info(alias_id, email_id, reply_to_alias_email_options, opts = {})
445
+ if @api_client.config.debugging
446
+ @api_client.config.logger.debug 'Calling API: AliasControllerApi.reply_to_alias_email ...'
447
+ end
448
+ # verify the required parameter 'alias_id' is set
449
+ if @api_client.config.client_side_validation && alias_id.nil?
450
+ fail ArgumentError, "Missing the required parameter 'alias_id' when calling AliasControllerApi.reply_to_alias_email"
451
+ end
452
+ # verify the required parameter 'email_id' is set
453
+ if @api_client.config.client_side_validation && email_id.nil?
454
+ fail ArgumentError, "Missing the required parameter 'email_id' when calling AliasControllerApi.reply_to_alias_email"
455
+ end
456
+ # verify the required parameter 'reply_to_alias_email_options' is set
457
+ if @api_client.config.client_side_validation && reply_to_alias_email_options.nil?
458
+ fail ArgumentError, "Missing the required parameter 'reply_to_alias_email_options' when calling AliasControllerApi.reply_to_alias_email"
459
+ end
460
+ # resource path
461
+ local_var_path = '/aliases/{aliasId}/emails/{emailId}'.sub('{' + 'aliasId' + '}', CGI.escape(alias_id.to_s)).sub('{' + 'emailId' + '}', CGI.escape(email_id.to_s))
462
+
463
+ # query parameters
464
+ query_params = opts[:query_params] || {}
465
+
466
+ # header parameters
467
+ header_params = opts[:header_params] || {}
468
+ # HTTP header 'Accept' (if needed)
469
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
470
+ # HTTP header 'Content-Type'
471
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
472
+
473
+ # form parameters
474
+ form_params = opts[:form_params] || {}
475
+
476
+ # http body (model)
477
+ post_body = opts[:body] || @api_client.object_to_http_body(reply_to_alias_email_options)
478
+
479
+ # return_type
480
+ return_type = opts[:return_type] || 'SentEmailDto'
481
+
482
+ # auth_names
483
+ auth_names = opts[:auth_names] || ['API_KEY']
484
+
485
+ new_options = opts.merge(
486
+ :header_params => header_params,
487
+ :query_params => query_params,
488
+ :form_params => form_params,
489
+ :body => post_body,
490
+ :auth_names => auth_names,
491
+ :return_type => return_type
492
+ )
493
+
494
+ data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
495
+ if @api_client.config.debugging
496
+ @api_client.config.logger.debug "API called: AliasControllerApi#reply_to_alias_email\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
497
+ end
498
+ return data, status_code, headers
499
+ end
500
+
501
+ # Send an email from an alias inbox
502
+ # Send an email from an alias. Replies to the email will be forwarded to the alias masked email address
503
+ # @param alias_id [String] aliasId
504
+ # @param [Hash] opts the optional parameters
505
+ # @option opts [SendEmailOptions] :send_email_options Options for the email to be sent
506
+ # @return [SentEmailDto]
507
+ def send_alias_email(alias_id, opts = {})
508
+ data, _status_code, _headers = send_alias_email_with_http_info(alias_id, opts)
509
+ data
510
+ end
511
+
512
+ # Send an email from an alias inbox
513
+ # Send an email from an alias. Replies to the email will be forwarded to the alias masked email address
514
+ # @param alias_id [String] aliasId
515
+ # @param [Hash] opts the optional parameters
516
+ # @option opts [SendEmailOptions] :send_email_options Options for the email to be sent
517
+ # @return [Array<(SentEmailDto, Integer, Hash)>] SentEmailDto data, response status code and response headers
518
+ def send_alias_email_with_http_info(alias_id, opts = {})
519
+ if @api_client.config.debugging
520
+ @api_client.config.logger.debug 'Calling API: AliasControllerApi.send_alias_email ...'
521
+ end
522
+ # verify the required parameter 'alias_id' is set
523
+ if @api_client.config.client_side_validation && alias_id.nil?
524
+ fail ArgumentError, "Missing the required parameter 'alias_id' when calling AliasControllerApi.send_alias_email"
525
+ end
526
+ # resource path
527
+ local_var_path = '/aliases/{aliasId}/emails'.sub('{' + 'aliasId' + '}', CGI.escape(alias_id.to_s))
528
+
529
+ # query parameters
530
+ query_params = opts[:query_params] || {}
531
+
532
+ # header parameters
533
+ header_params = opts[:header_params] || {}
534
+ # HTTP header 'Accept' (if needed)
535
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
536
+ # HTTP header 'Content-Type'
537
+ header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
538
+
539
+ # form parameters
540
+ form_params = opts[:form_params] || {}
541
+
542
+ # http body (model)
543
+ post_body = opts[:body] || @api_client.object_to_http_body(opts[:'send_email_options'])
544
+
545
+ # return_type
546
+ return_type = opts[:return_type] || 'SentEmailDto'
547
+
548
+ # auth_names
549
+ auth_names = opts[:auth_names] || ['API_KEY']
550
+
551
+ new_options = opts.merge(
552
+ :header_params => header_params,
553
+ :query_params => query_params,
554
+ :form_params => form_params,
555
+ :body => post_body,
556
+ :auth_names => auth_names,
557
+ :return_type => return_type
558
+ )
559
+
560
+ data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
561
+ if @api_client.config.debugging
562
+ @api_client.config.logger.debug "API called: AliasControllerApi#send_alias_email\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
563
+ end
564
+ return data, status_code, headers
565
+ end
566
+
350
567
  # Update an email alias
351
568
  # @param alias_id [String] aliasId
352
569
  # @param update_alias_options [UpdateAliasOptions] updateAliasOptions
@@ -22,6 +22,9 @@ module MailSlurpClient
22
22
  # Create new random inbox
23
23
  # Returns an Inbox with an `id` and an `emailAddress`
24
24
  # @param [Hash] opts the optional parameters
25
+ # @option opts [DateTime] :expires_at expiresAt
26
+ # @option opts [Integer] :expires_in expiresIn
27
+ # @option opts [Boolean] :use_domain_pool useDomainPool
25
28
  # @return [Inbox]
26
29
  def create_new_email_address(opts = {})
27
30
  data, _status_code, _headers = create_new_email_address_with_http_info(opts)
@@ -31,6 +34,9 @@ module MailSlurpClient
31
34
  # Create new random inbox
32
35
  # Returns an Inbox with an &#x60;id&#x60; and an &#x60;emailAddress&#x60;
33
36
  # @param [Hash] opts the optional parameters
37
+ # @option opts [DateTime] :expires_at expiresAt
38
+ # @option opts [Integer] :expires_in expiresIn
39
+ # @option opts [Boolean] :use_domain_pool useDomainPool
34
40
  # @return [Array<(Inbox, Integer, Hash)>] Inbox data, response status code and response headers
35
41
  def create_new_email_address_with_http_info(opts = {})
36
42
  if @api_client.config.debugging
@@ -41,6 +47,9 @@ module MailSlurpClient
41
47
 
42
48
  # query parameters
43
49
  query_params = opts[:query_params] || {}
50
+ query_params[:'expiresAt'] = opts[:'expires_at'] if !opts[:'expires_at'].nil?
51
+ query_params[:'expiresIn'] = opts[:'expires_in'] if !opts[:'expires_in'].nil?
52
+ query_params[:'useDomainPool'] = opts[:'use_domain_pool'] if !opts[:'use_domain_pool'].nil?
44
53
 
45
54
  # header parameters
46
55
  header_params = opts[:header_params] || {}
@@ -78,6 +87,9 @@ module MailSlurpClient
78
87
  # Create new random inbox
79
88
  # Returns an Inbox with an `id` and an `emailAddress`
80
89
  # @param [Hash] opts the optional parameters
90
+ # @option opts [DateTime] :expires_at expiresAt
91
+ # @option opts [Integer] :expires_in expiresIn
92
+ # @option opts [Boolean] :use_domain_pool useDomainPool
81
93
  # @return [Inbox]
82
94
  def create_new_email_address1(opts = {})
83
95
  data, _status_code, _headers = create_new_email_address1_with_http_info(opts)
@@ -87,6 +99,9 @@ module MailSlurpClient
87
99
  # Create new random inbox
88
100
  # Returns an Inbox with an &#x60;id&#x60; and an &#x60;emailAddress&#x60;
89
101
  # @param [Hash] opts the optional parameters
102
+ # @option opts [DateTime] :expires_at expiresAt
103
+ # @option opts [Integer] :expires_in expiresIn
104
+ # @option opts [Boolean] :use_domain_pool useDomainPool
90
105
  # @return [Array<(Inbox, Integer, Hash)>] Inbox data, response status code and response headers
91
106
  def create_new_email_address1_with_http_info(opts = {})
92
107
  if @api_client.config.debugging
@@ -97,6 +112,9 @@ module MailSlurpClient
97
112
 
98
113
  # query parameters
99
114
  query_params = opts[:query_params] || {}
115
+ query_params[:'expiresAt'] = opts[:'expires_at'] if !opts[:'expires_at'].nil?
116
+ query_params[:'expiresIn'] = opts[:'expires_in'] if !opts[:'expires_in'].nil?
117
+ query_params[:'useDomainPool'] = opts[:'use_domain_pool'] if !opts[:'use_domain_pool'].nil?
100
118
 
101
119
  # header parameters
102
120
  header_params = opts[:header_params] || {}
@@ -927,7 +927,7 @@ module MailSlurpClient
927
927
 
928
928
  # Reply to an email
929
929
  # Send the reply to the email sender or reply-to and include same subject cc bcc etc. Reply to an email and the contents will be sent with the existing subject to the emails `to`, `cc`, and `bcc`.
930
- # @param email_id [String] emailId
930
+ # @param email_id [String] ID of the email that should be replied to
931
931
  # @param reply_to_email_options [ReplyToEmailOptions] replyToEmailOptions
932
932
  # @param [Hash] opts the optional parameters
933
933
  # @return [SentEmailDto]
@@ -938,7 +938,7 @@ module MailSlurpClient
938
938
 
939
939
  # Reply to an email
940
940
  # Send the reply to the email sender or reply-to and include same subject cc bcc etc. Reply to an email and the contents will be sent with the existing subject to the emails &#x60;to&#x60;, &#x60;cc&#x60;, and &#x60;bcc&#x60;.
941
- # @param email_id [String] emailId
941
+ # @param email_id [String] ID of the email that should be replied to
942
942
  # @param reply_to_email_options [ReplyToEmailOptions] replyToEmailOptions
943
943
  # @param [Hash] opts the optional parameters
944
944
  # @return [Array<(SentEmailDto, Integer, Hash)>] SentEmailDto data, response status code and response headers
@@ -22,12 +22,14 @@ module MailSlurpClient
22
22
  # Create an Inbox (email address)
23
23
  # Create a new inbox and with a randomized email address to send and receive from. Pass emailAddress parameter if you wish to use a specific email address. Creating an inbox is required before sending or receiving emails. If writing tests it is recommended that you create a new inbox during each test method so that it is unique and empty.
24
24
  # @param [Hash] opts the optional parameters
25
- # @option opts [String] :description Optional description for an inbox.
26
- # @option opts [String] :email_address Optional email address including domain you wish inbox to use (eg: test123@mydomain.com). Only supports domains that you have registered and verified with MailSlurp using dashboard or &#x60;createDomain&#x60; method.
27
- # @option opts [DateTime] :expires_at Optional expires at timestamp. If your plan supports this feature you can specify when an inbox should expire. If left empty inbox will exist permanently or expire when your plan dictates
28
- # @option opts [Boolean] :favourite Is inbox favourited.
29
- # @option opts [String] :name Optional name for an inbox.
30
- # @option opts [Array<String>] :tags Optional tags for an inbox. Can be used for searching and filtering inboxes.
25
+ # @option opts [String] :description Optional description of the inbox for labelling purposes. Is shown in the dashboard and can be used with
26
+ # @option opts [String] :email_address A custom email address to use with the inbox. Defaults to null. When null MailSlurp will assign a random email address to the inbox such as &#x60;123@mailslurp.com&#x60;. If you use the &#x60;useDomainPool&#x60; option when the email address is null it will generate an email address with a more varied domain ending such as &#x60;123@mailslurp.info&#x60; or &#x60;123@mailslurp.biz&#x60;. When a custom email address is provided the address is split into a domain and the domain is queried against your user. If you have created the domain in the MailSlurp dashboard and verified it you can use any email address that ends with the domain. Send an email to this address and the inbox will receive and store it for you. To retrieve the email use the Inbox and Email Controller endpoints with the inbox ID.
27
+ # @option opts [DateTime] :expires_at Optional inbox expiration date. If null then this inbox is permanent and the emails in it won&#39;t be deleted. If an expiration date is provided or is required by your plan the inbox will be closed when the expiration time is reached. Expired inboxes still contain their emails but can no longer send or receive emails. An ExpiredInboxRecord is created when an inbox and the email address and inbox ID are recorded. The expiresAt property is a timestamp string in ISO DateTime Format yyyy-MM-dd&#39;T&#39;HH:mm:ss.SSSXXX.
28
+ # @option opts [Integer] :expires_in Number of milliseconds that inbox should exist for
29
+ # @option opts [Boolean] :favourite Is the inbox favorited. Favouriting inboxes is typically done in the dashboard for quick access or filtering
30
+ # @option opts [String] :name Optional name of the inbox. Displayed in the dashboard for easier search
31
+ # @option opts [Array<String>] :tags Tags that inbox has been tagged with. Tags can be added to inboxes to group different inboxes within an account. You can also search for inboxes by tag in the dashboard UI.
32
+ # @option opts [Boolean] :use_domain_pool Use the MailSlurp domain name pool with this inbox when creating the email address. Defaults to null. If enabled the inbox will be an email address with a domain randomly chosen from a list of the MailSlurp domains. This is useful when the default &#x60;@mailslurp.com&#x60; email addresses used with inboxes are blocked or considered spam by a provider or receiving service. When domain pool is enabled an email address will be generated ending in &#x60;@mailslurp.{world,info,xyz,...}&#x60; . This means a TLD is randomly selecting from a list of &#x60;.biz&#x60;, &#x60;.info&#x60;, &#x60;.xyz&#x60; etc to add variance to the generated email addresses. When null or false MailSlurp uses the default behavior of &#x60;@mailslurp.com&#x60; or custom email address provided by the emailAddress field.
31
33
  # @return [Inbox]
32
34
  def create_inbox(opts = {})
33
35
  data, _status_code, _headers = create_inbox_with_http_info(opts)
@@ -37,12 +39,14 @@ module MailSlurpClient
37
39
  # Create an Inbox (email address)
38
40
  # Create a new inbox and with a randomized email address to send and receive from. Pass emailAddress parameter if you wish to use a specific email address. Creating an inbox is required before sending or receiving emails. If writing tests it is recommended that you create a new inbox during each test method so that it is unique and empty.
39
41
  # @param [Hash] opts the optional parameters
40
- # @option opts [String] :description Optional description for an inbox.
41
- # @option opts [String] :email_address Optional email address including domain you wish inbox to use (eg: test123@mydomain.com). Only supports domains that you have registered and verified with MailSlurp using dashboard or &#x60;createDomain&#x60; method.
42
- # @option opts [DateTime] :expires_at Optional expires at timestamp. If your plan supports this feature you can specify when an inbox should expire. If left empty inbox will exist permanently or expire when your plan dictates
43
- # @option opts [Boolean] :favourite Is inbox favourited.
44
- # @option opts [String] :name Optional name for an inbox.
45
- # @option opts [Array<String>] :tags Optional tags for an inbox. Can be used for searching and filtering inboxes.
42
+ # @option opts [String] :description Optional description of the inbox for labelling purposes. Is shown in the dashboard and can be used with
43
+ # @option opts [String] :email_address A custom email address to use with the inbox. Defaults to null. When null MailSlurp will assign a random email address to the inbox such as &#x60;123@mailslurp.com&#x60;. If you use the &#x60;useDomainPool&#x60; option when the email address is null it will generate an email address with a more varied domain ending such as &#x60;123@mailslurp.info&#x60; or &#x60;123@mailslurp.biz&#x60;. When a custom email address is provided the address is split into a domain and the domain is queried against your user. If you have created the domain in the MailSlurp dashboard and verified it you can use any email address that ends with the domain. Send an email to this address and the inbox will receive and store it for you. To retrieve the email use the Inbox and Email Controller endpoints with the inbox ID.
44
+ # @option opts [DateTime] :expires_at Optional inbox expiration date. If null then this inbox is permanent and the emails in it won&#39;t be deleted. If an expiration date is provided or is required by your plan the inbox will be closed when the expiration time is reached. Expired inboxes still contain their emails but can no longer send or receive emails. An ExpiredInboxRecord is created when an inbox and the email address and inbox ID are recorded. The expiresAt property is a timestamp string in ISO DateTime Format yyyy-MM-dd&#39;T&#39;HH:mm:ss.SSSXXX.
45
+ # @option opts [Integer] :expires_in Number of milliseconds that inbox should exist for
46
+ # @option opts [Boolean] :favourite Is the inbox favorited. Favouriting inboxes is typically done in the dashboard for quick access or filtering
47
+ # @option opts [String] :name Optional name of the inbox. Displayed in the dashboard for easier search
48
+ # @option opts [Array<String>] :tags Tags that inbox has been tagged with. Tags can be added to inboxes to group different inboxes within an account. You can also search for inboxes by tag in the dashboard UI.
49
+ # @option opts [Boolean] :use_domain_pool Use the MailSlurp domain name pool with this inbox when creating the email address. Defaults to null. If enabled the inbox will be an email address with a domain randomly chosen from a list of the MailSlurp domains. This is useful when the default &#x60;@mailslurp.com&#x60; email addresses used with inboxes are blocked or considered spam by a provider or receiving service. When domain pool is enabled an email address will be generated ending in &#x60;@mailslurp.{world,info,xyz,...}&#x60; . This means a TLD is randomly selecting from a list of &#x60;.biz&#x60;, &#x60;.info&#x60;, &#x60;.xyz&#x60; etc to add variance to the generated email addresses. When null or false MailSlurp uses the default behavior of &#x60;@mailslurp.com&#x60; or custom email address provided by the emailAddress field.
46
50
  # @return [Array<(Inbox, Integer, Hash)>] Inbox data, response status code and response headers
47
51
  def create_inbox_with_http_info(opts = {})
48
52
  if @api_client.config.debugging
@@ -56,9 +60,11 @@ module MailSlurpClient
56
60
  query_params[:'description'] = opts[:'description'] if !opts[:'description'].nil?
57
61
  query_params[:'emailAddress'] = opts[:'email_address'] if !opts[:'email_address'].nil?
58
62
  query_params[:'expiresAt'] = opts[:'expires_at'] if !opts[:'expires_at'].nil?
63
+ query_params[:'expiresIn'] = opts[:'expires_in'] if !opts[:'expires_in'].nil?
59
64
  query_params[:'favourite'] = opts[:'favourite'] if !opts[:'favourite'].nil?
60
65
  query_params[:'name'] = opts[:'name'] if !opts[:'name'].nil?
61
66
  query_params[:'tags'] = @api_client.build_collection_param(opts[:'tags'], :multi) if !opts[:'tags'].nil?
67
+ query_params[:'useDomainPool'] = opts[:'use_domain_pool'] if !opts[:'use_domain_pool'].nil?
62
68
 
63
69
  # header parameters
64
70
  header_params = opts[:header_params] || {}
@@ -212,7 +218,7 @@ module MailSlurpClient
212
218
  end
213
219
 
214
220
  # Delete inbox
215
- # Permanently delete an inbox and associated email address aswell as all emails within the given inbox. This action cannot be undone. Note: deleting an inbox will not affect your account usage. Monthly inbox usage is based on how many inboxes you create within 30 days, not how many exist at time of request.
221
+ # Permanently delete an inbox and associated email address as well as all emails within the given inbox. This action cannot be undone. Note: deleting an inbox will not affect your account usage. Monthly inbox usage is based on how many inboxes you create within 30 days, not how many exist at time of request.
216
222
  # @param inbox_id [String] inboxId
217
223
  # @param [Hash] opts the optional parameters
218
224
  # @return [nil]
@@ -222,7 +228,7 @@ module MailSlurpClient
222
228
  end
223
229
 
224
230
  # Delete inbox
225
- # Permanently delete an inbox and associated email address aswell as all emails within the given inbox. This action cannot be undone. Note: deleting an inbox will not affect your account usage. Monthly inbox usage is based on how many inboxes you create within 30 days, not how many exist at time of request.
231
+ # Permanently delete an inbox and associated email address as well as all emails within the given inbox. This action cannot be undone. Note: deleting an inbox will not affect your account usage. Monthly inbox usage is based on how many inboxes you create within 30 days, not how many exist at time of request.
226
232
  # @param inbox_id [String] inboxId
227
233
  # @param [Hash] opts the optional parameters
228
234
  # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -433,6 +439,199 @@ module MailSlurpClient
433
439
  return data, status_code, headers
434
440
  end
435
441
 
442
+ # Get an expired inbox record
443
+ # Inboxes created with an expiration date will expire after the given date and be moved to an ExpiredInbox entity. You can still read emails in the inbox but it can no longer send or receive emails. Fetch the expired inboxes to view the old inboxes properties
444
+ # @param expired_id [String] ID of the ExpiredInboxRecord you want to retrieve. This is different from the ID of the inbox you are interested in. See other methods for getting ExpiredInboxRecord for an inbox inboxId)
445
+ # @param [Hash] opts the optional parameters
446
+ # @return [ExpiredInboxDto]
447
+ def get_expired_inbox_record_by_id(expired_id, opts = {})
448
+ data, _status_code, _headers = get_expired_inbox_record_by_id_with_http_info(expired_id, opts)
449
+ data
450
+ end
451
+
452
+ # Get an expired inbox record
453
+ # Inboxes created with an expiration date will expire after the given date and be moved to an ExpiredInbox entity. You can still read emails in the inbox but it can no longer send or receive emails. Fetch the expired inboxes to view the old inboxes properties
454
+ # @param expired_id [String] ID of the ExpiredInboxRecord you want to retrieve. This is different from the ID of the inbox you are interested in. See other methods for getting ExpiredInboxRecord for an inbox inboxId)
455
+ # @param [Hash] opts the optional parameters
456
+ # @return [Array<(ExpiredInboxDto, Integer, Hash)>] ExpiredInboxDto data, response status code and response headers
457
+ def get_expired_inbox_record_by_id_with_http_info(expired_id, opts = {})
458
+ if @api_client.config.debugging
459
+ @api_client.config.logger.debug 'Calling API: InboxControllerApi.get_expired_inbox_record_by_id ...'
460
+ end
461
+ # verify the required parameter 'expired_id' is set
462
+ if @api_client.config.client_side_validation && expired_id.nil?
463
+ fail ArgumentError, "Missing the required parameter 'expired_id' when calling InboxControllerApi.get_expired_inbox_record_by_id"
464
+ end
465
+ # resource path
466
+ local_var_path = '/inboxes/expired-records/{expiredId}'.sub('{' + 'expiredId' + '}', CGI.escape(expired_id.to_s))
467
+
468
+ # query parameters
469
+ query_params = opts[:query_params] || {}
470
+
471
+ # header parameters
472
+ header_params = opts[:header_params] || {}
473
+ # HTTP header 'Accept' (if needed)
474
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
475
+
476
+ # form parameters
477
+ form_params = opts[:form_params] || {}
478
+
479
+ # http body (model)
480
+ post_body = opts[:body]
481
+
482
+ # return_type
483
+ return_type = opts[:return_type] || 'ExpiredInboxDto'
484
+
485
+ # auth_names
486
+ auth_names = opts[:auth_names] || ['API_KEY']
487
+
488
+ new_options = opts.merge(
489
+ :header_params => header_params,
490
+ :query_params => query_params,
491
+ :form_params => form_params,
492
+ :body => post_body,
493
+ :auth_names => auth_names,
494
+ :return_type => return_type
495
+ )
496
+
497
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
498
+ if @api_client.config.debugging
499
+ @api_client.config.logger.debug "API called: InboxControllerApi#get_expired_inbox_record_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
500
+ end
501
+ return data, status_code, headers
502
+ end
503
+
504
+ # Get expired inbox record for a previously existing inbox
505
+ # Use the inboxId to return an ExpiredInboxRecord if an inbox has expired. Inboxes expire and are disabled if an expiration date is set or plan requires. Returns 404 if no expired inbox is found for the inboxId
506
+ # @param inbox_id [String] ID of inbox you want to retrieve (not the inbox ID)
507
+ # @param [Hash] opts the optional parameters
508
+ # @return [ExpiredInboxDto]
509
+ def get_expired_inbox_record_by_inbox_id(inbox_id, opts = {})
510
+ data, _status_code, _headers = get_expired_inbox_record_by_inbox_id_with_http_info(inbox_id, opts)
511
+ data
512
+ end
513
+
514
+ # Get expired inbox record for a previously existing inbox
515
+ # Use the inboxId to return an ExpiredInboxRecord if an inbox has expired. Inboxes expire and are disabled if an expiration date is set or plan requires. Returns 404 if no expired inbox is found for the inboxId
516
+ # @param inbox_id [String] ID of inbox you want to retrieve (not the inbox ID)
517
+ # @param [Hash] opts the optional parameters
518
+ # @return [Array<(ExpiredInboxDto, Integer, Hash)>] ExpiredInboxDto data, response status code and response headers
519
+ def get_expired_inbox_record_by_inbox_id_with_http_info(inbox_id, opts = {})
520
+ if @api_client.config.debugging
521
+ @api_client.config.logger.debug 'Calling API: InboxControllerApi.get_expired_inbox_record_by_inbox_id ...'
522
+ end
523
+ # verify the required parameter 'inbox_id' is set
524
+ if @api_client.config.client_side_validation && inbox_id.nil?
525
+ fail ArgumentError, "Missing the required parameter 'inbox_id' when calling InboxControllerApi.get_expired_inbox_record_by_inbox_id"
526
+ end
527
+ # resource path
528
+ local_var_path = '/inboxes/{inboxId}/expired-record'.sub('{' + 'inboxId' + '}', CGI.escape(inbox_id.to_s))
529
+
530
+ # query parameters
531
+ query_params = opts[:query_params] || {}
532
+
533
+ # header parameters
534
+ header_params = opts[:header_params] || {}
535
+ # HTTP header 'Accept' (if needed)
536
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
537
+
538
+ # form parameters
539
+ form_params = opts[:form_params] || {}
540
+
541
+ # http body (model)
542
+ post_body = opts[:body]
543
+
544
+ # return_type
545
+ return_type = opts[:return_type] || 'ExpiredInboxDto'
546
+
547
+ # auth_names
548
+ auth_names = opts[:auth_names] || ['API_KEY']
549
+
550
+ new_options = opts.merge(
551
+ :header_params => header_params,
552
+ :query_params => query_params,
553
+ :form_params => form_params,
554
+ :body => post_body,
555
+ :auth_names => auth_names,
556
+ :return_type => return_type
557
+ )
558
+
559
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
560
+ if @api_client.config.debugging
561
+ @api_client.config.logger.debug "API called: InboxControllerApi#get_expired_inbox_record_by_inbox_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
562
+ end
563
+ return data, status_code, headers
564
+ end
565
+
566
+ # List records of expired inboxes
567
+ # Inboxes created with an expiration date will expire after the given date. An ExpiredInboxRecord is created that records the inboxes old ID and email address. You can still read emails in the inbox (using the inboxes old ID) but the email address associated with the inbox can no longer send or receive emails. Fetch expired inbox records to view the old inboxes properties
568
+ # @param [Hash] opts the optional parameters
569
+ # @option opts [Integer] :page Optional page index in inbox sent email list pagination (default to 0)
570
+ # @option opts [Integer] :size Optional page size in inbox sent email list pagination (default to 20)
571
+ # @option opts [String] :sort Optional createdAt sort direction ASC or DESC (default to 'ASC')
572
+ # @return [PageExpiredInboxRecordProjection]
573
+ def get_expired_inbox_records(opts = {})
574
+ data, _status_code, _headers = get_expired_inbox_records_with_http_info(opts)
575
+ data
576
+ end
577
+
578
+ # List records of expired inboxes
579
+ # Inboxes created with an expiration date will expire after the given date. An ExpiredInboxRecord is created that records the inboxes old ID and email address. You can still read emails in the inbox (using the inboxes old ID) but the email address associated with the inbox can no longer send or receive emails. Fetch expired inbox records to view the old inboxes properties
580
+ # @param [Hash] opts the optional parameters
581
+ # @option opts [Integer] :page Optional page index in inbox sent email list pagination
582
+ # @option opts [Integer] :size Optional page size in inbox sent email list pagination
583
+ # @option opts [String] :sort Optional createdAt sort direction ASC or DESC
584
+ # @return [Array<(PageExpiredInboxRecordProjection, Integer, Hash)>] PageExpiredInboxRecordProjection data, response status code and response headers
585
+ def get_expired_inbox_records_with_http_info(opts = {})
586
+ if @api_client.config.debugging
587
+ @api_client.config.logger.debug 'Calling API: InboxControllerApi.get_expired_inbox_records ...'
588
+ end
589
+ allowable_values = ["ASC", "DESC"]
590
+ if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
591
+ fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
592
+ end
593
+ # resource path
594
+ local_var_path = '/inboxes/expired-records'
595
+
596
+ # query parameters
597
+ query_params = opts[:query_params] || {}
598
+ query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
599
+ query_params[:'size'] = opts[:'size'] if !opts[:'size'].nil?
600
+ query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
601
+
602
+ # header parameters
603
+ header_params = opts[:header_params] || {}
604
+ # HTTP header 'Accept' (if needed)
605
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
606
+
607
+ # form parameters
608
+ form_params = opts[:form_params] || {}
609
+
610
+ # http body (model)
611
+ post_body = opts[:body]
612
+
613
+ # return_type
614
+ return_type = opts[:return_type] || 'PageExpiredInboxRecordProjection'
615
+
616
+ # auth_names
617
+ auth_names = opts[:auth_names] || ['API_KEY']
618
+
619
+ new_options = opts.merge(
620
+ :header_params => header_params,
621
+ :query_params => query_params,
622
+ :form_params => form_params,
623
+ :body => post_body,
624
+ :auth_names => auth_names,
625
+ :return_type => return_type
626
+ )
627
+
628
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
629
+ if @api_client.config.debugging
630
+ @api_client.config.logger.debug "API called: InboxControllerApi#get_expired_inbox_records\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
631
+ end
632
+ return data, status_code, headers
633
+ end
634
+
436
635
  # Get Inbox
437
636
  # Returns an inbox's properties, including its email address and ID.
438
637
  # @param inbox_id [String] inboxId