dropbox-sign 1.6.1 → 1.8.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.
Files changed (94) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile.lock +1 -1
  3. data/README.md +15 -5
  4. data/VERSION +1 -1
  5. data/docs/AccountResponseQuotas.md +1 -1
  6. data/docs/BulkSendJobGetResponseSignatureRequests.md +1 -1
  7. data/docs/FaxApi.md +364 -0
  8. data/docs/FaxGetResponse.md +11 -0
  9. data/docs/FaxListResponse.md +11 -0
  10. data/docs/FaxResponse.md +20 -0
  11. data/docs/FaxResponseTransmission.md +12 -0
  12. data/docs/FaxSendRequest.md +18 -0
  13. data/docs/OAuthTokenRefreshRequest.md +2 -0
  14. data/docs/SignatureRequestApi.md +1 -1
  15. data/docs/SignatureRequestResponse.md +1 -1
  16. data/docs/SignatureRequestResponseDataValueInitials.md +1 -0
  17. data/docs/SignatureRequestResponseDataValueSignature.md +1 -0
  18. data/docs/SubWhiteLabelingOptions.md +12 -12
  19. data/docs/TemplateApi.md +3 -3
  20. data/docs/TemplateResponse.md +3 -2
  21. data/docs/TemplateResponseDocumentFormFieldBase.md +0 -1
  22. data/docs/TemplateResponseDocumentFormFieldCheckbox.md +1 -0
  23. data/docs/TemplateResponseDocumentFormFieldDateSigned.md +1 -0
  24. data/docs/TemplateResponseDocumentFormFieldDropdown.md +1 -0
  25. data/docs/TemplateResponseDocumentFormFieldHyperlink.md +1 -0
  26. data/docs/TemplateResponseDocumentFormFieldInitials.md +1 -0
  27. data/docs/TemplateResponseDocumentFormFieldRadio.md +1 -0
  28. data/docs/TemplateResponseDocumentFormFieldSignature.md +1 -0
  29. data/docs/TemplateResponseDocumentFormFieldText.md +1 -0
  30. data/examples/FaxDelete.rb +14 -0
  31. data/examples/FaxFiles.rb +17 -0
  32. data/examples/FaxGet.rb +17 -0
  33. data/examples/FaxList.rb +18 -0
  34. data/examples/FaxSend.rb +25 -0
  35. data/lib/dropbox-sign/api/fax_api.rb +495 -0
  36. data/lib/dropbox-sign/api/o_auth_api.rb +28 -0
  37. data/lib/dropbox-sign/api/signature_request_api.rb +2 -2
  38. data/lib/dropbox-sign/api/template_api.rb +2 -2
  39. data/lib/dropbox-sign/models/account_response_quotas.rb +1 -1
  40. data/lib/dropbox-sign/models/api_app_response_o_auth.rb +2 -1
  41. data/lib/dropbox-sign/models/bulk_send_job_get_response_signature_requests.rb +10 -7
  42. data/lib/dropbox-sign/models/fax_get_response.rb +263 -0
  43. data/lib/dropbox-sign/models/fax_list_response.rb +267 -0
  44. data/lib/dropbox-sign/models/fax_response.rb +403 -0
  45. data/lib/dropbox-sign/models/fax_response_transmission.rb +312 -0
  46. data/lib/dropbox-sign/models/fax_send_request.rb +345 -0
  47. data/lib/dropbox-sign/models/o_auth_token_refresh_request.rb +26 -4
  48. data/lib/dropbox-sign/models/signature_request_response.rb +10 -7
  49. data/lib/dropbox-sign/models/signature_request_response_custom_field_base.rb +2 -1
  50. data/lib/dropbox-sign/models/signature_request_response_data_value_initials.rb +16 -4
  51. data/lib/dropbox-sign/models/signature_request_response_data_value_signature.rb +16 -4
  52. data/lib/dropbox-sign/models/sub_white_labeling_options.rb +12 -12
  53. data/lib/dropbox-sign/models/template_response.rb +27 -16
  54. data/lib/dropbox-sign/models/template_response_document.rb +1 -2
  55. data/lib/dropbox-sign/models/template_response_document_form_field_base.rb +4 -16
  56. data/lib/dropbox-sign/models/template_response_document_form_field_checkbox.rb +16 -4
  57. data/lib/dropbox-sign/models/template_response_document_form_field_date_signed.rb +16 -4
  58. data/lib/dropbox-sign/models/template_response_document_form_field_dropdown.rb +16 -4
  59. data/lib/dropbox-sign/models/template_response_document_form_field_hyperlink.rb +16 -4
  60. data/lib/dropbox-sign/models/template_response_document_form_field_initials.rb +16 -4
  61. data/lib/dropbox-sign/models/template_response_document_form_field_radio.rb +20 -4
  62. data/lib/dropbox-sign/models/template_response_document_form_field_signature.rb +16 -4
  63. data/lib/dropbox-sign/models/template_response_document_form_field_text.rb +17 -5
  64. data/lib/dropbox-sign/version.rb +1 -1
  65. data/lib/dropbox-sign.rb +6 -0
  66. data/openapi-config.yaml +1 -1
  67. data/openapi-sdk.yaml +821 -98
  68. data/run-build +9 -0
  69. data/test_fixtures/ApiAppCreateRequest.json +10 -10
  70. data/test_fixtures/ApiAppGetResponse.json +18 -3
  71. data/test_fixtures/ApiAppListResponse.json +7 -1
  72. data/test_fixtures/ApiAppUpdateRequest.json +11 -11
  73. data/test_fixtures/BulkSendJobGetResponse.json +9 -0
  74. data/test_fixtures/FaxGetResponse.json +31 -0
  75. data/test_fixtures/FaxListResponse.json +39 -0
  76. data/test_fixtures/FaxSendRequest.json +14 -0
  77. data/test_fixtures/FaxSendResponse.json +16 -0
  78. data/test_fixtures/SignatureRequestBulkCreateEmbeddedWithTemplateRequest.json +7 -1
  79. data/test_fixtures/SignatureRequestBulkSendWithTemplateRequest.json +7 -1
  80. data/test_fixtures/SignatureRequestCreateEmbeddedRequest.json +7 -1
  81. data/test_fixtures/SignatureRequestCreateEmbeddedWithTemplateRequest.json +7 -1
  82. data/test_fixtures/SignatureRequestGetResponse.json +11 -1
  83. data/test_fixtures/SignatureRequestListResponse.json +9 -1
  84. data/test_fixtures/SignatureRequestSendRequest.json +5 -1
  85. data/test_fixtures/SignatureRequestSendWithTemplateRequest.json +7 -1
  86. data/test_fixtures/TeamGetResponse.json +5 -0
  87. data/test_fixtures/TemplateCreateEmbeddedDraftRequest.json +5 -0
  88. data/test_fixtures/TemplateCreateRequest.json +5 -0
  89. data/test_fixtures/TemplateGetResponse.json +34 -479
  90. data/test_fixtures/TemplateListResponse.json +43 -6
  91. data/test_fixtures/UnclaimedDraftCreateEmbeddedRequest.json +5 -0
  92. data/test_fixtures/UnclaimedDraftCreateEmbeddedWithTemplateRequest.json +5 -0
  93. data/test_fixtures/UnclaimedDraftCreateRequest.json +5 -0
  94. metadata +29 -8
@@ -10,15 +10,16 @@ Contains information about the templates you and your team have created.
10
10
  | `title` | ```String``` | The title of the Template. This will also be the default subject of the message sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | |
11
11
  | `message` | ```String``` | The default message that will be sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | |
12
12
  | `updated_at` | ```Integer``` | Time the template was last updated. | |
13
- | `is_embedded` | ```Boolean``` | `true` if this template was created using an embedded flow, `false` if it was created on our website. | |
13
+ | `is_embedded` | ```Boolean``` | `true` if this template was created using an embedded flow, `false` if it was created on our website. Will be `null` when you are not the creator of the Template. | |
14
14
  | `is_creator` | ```Boolean``` | `true` if you are the owner of this template, `false` if it's been shared with you by a team member. | |
15
15
  | `can_edit` | ```Boolean``` | Indicates whether edit rights have been granted to you by the owner (always `true` if that's you). | |
16
16
  | `is_locked` | ```Boolean``` | Indicates whether the template is locked. If `true`, then the template was created outside your quota and can only be used in `test_mode`. If `false`, then the template is within your quota and can be used to create signature requests. | |
17
- | `metadata` | ```Object``` | The metadata attached to the template. | |
17
+ | `metadata` | ```Hash<String, Object>``` | The metadata attached to the template. | |
18
18
  | `signer_roles` | [```Array<TemplateResponseSignerRole>```](TemplateResponseSignerRole.md) | An array of the designated signer roles that must be specified when sending a SignatureRequest using this Template. | |
19
19
  | `cc_roles` | [```Array<TemplateResponseCCRole>```](TemplateResponseCCRole.md) | An array of the designated CC roles that must be specified when sending a SignatureRequest using this Template. | |
20
20
  | `documents` | [```Array<TemplateResponseDocument>```](TemplateResponseDocument.md) | An array describing each document associated with this Template. Includes form field data for each document. | |
21
21
  | `custom_fields` | [```Array<TemplateResponseDocumentCustomFieldBase>```](TemplateResponseDocumentCustomFieldBase.md) | Deprecated. Use `custom_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c&#x3D;200&amp;path&#x3D;template/documents&amp;t&#x3D;response) array instead. | |
22
22
  | `named_form_fields` | [```Array<TemplateResponseDocumentFormFieldBase>```](TemplateResponseDocumentFormFieldBase.md) | Deprecated. Use `form_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c&#x3D;200&amp;path&#x3D;template/documents&amp;t&#x3D;response) array instead. | |
23
23
  | `accounts` | [```Array<TemplateResponseAccount>```](TemplateResponseAccount.md) | An array of the Accounts that can use this Template. | |
24
+ | `attachments` | [```Array<SignatureRequestResponseAttachment>```](SignatureRequestResponseAttachment.md) | Signer attachments. | |
24
25
 
@@ -15,5 +15,4 @@ An array of Form Field objects containing the name and type of each named field.
15
15
  | `width` | ```Integer``` | The width in pixels of this form field. | |
16
16
  | `height` | ```Integer``` | The height in pixels of this form field. | |
17
17
  | `required` | ```Boolean``` | Boolean showing whether or not this field is required. | |
18
- | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
19
18
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'checkbox'] |
10
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'date_signed'] |
10
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'dropdown'] |
10
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -11,4 +11,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
11
11
  | `is_multiline` | ```Boolean``` | Whether this form field is multiline text. | |
12
12
  | `original_font_size` | ```Integer``` | Original font size used in this form field&#39;s text. | |
13
13
  | `font_family` | ```String``` | Font family used in this form field&#39;s text. | |
14
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
14
15
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'initials'] |
10
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'radio'] |
10
+ | `group`<sup>*_required_</sup> | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -7,4 +7,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
7
7
  | Name | Type | Description | Notes |
8
8
  | ---- | ---- | ----------- | ----- |
9
9
  | `type`<sup>*_required_</sup> | ```String``` | The type of this form field. See [field types](/api/reference/constants/#field-types).<br><br>* Text Field uses `TemplateResponseDocumentFormFieldText`<br>* Dropdown Field uses `TemplateResponseDocumentFormFieldDropdown`<br>* Hyperlink Field uses `TemplateResponseDocumentFormFieldHyperlink`<br>* Checkbox Field uses `TemplateResponseDocumentFormFieldCheckbox`<br>* Radio Field uses `TemplateResponseDocumentFormFieldRadio`<br>* Signature Field uses `TemplateResponseDocumentFormFieldSignature`<br>* Date Signed Field uses `TemplateResponseDocumentFormFieldDateSigned`<br>* Initials Field uses `TemplateResponseDocumentFormFieldInitials` | [default to 'signature'] |
10
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
10
11
 
@@ -12,4 +12,5 @@ This class extends `TemplateResponseDocumentFormFieldBase`
12
12
  | `original_font_size` | ```Integer``` | Original font size used in this form field&#39;s text. | |
13
13
  | `font_family` | ```String``` | Font family used in this form field&#39;s text. | |
14
14
  | `validation_type` | ```String``` | Each text field may contain a `validation_type` parameter. Check out the list of [validation types](https://faq.hellosign.com/hc/en-us/articles/217115577) to learn more about the possible values. | |
15
+ | `group` | ```String``` | The name of the group this field is in. If this field is not a group, this defaults to `null` except for Radio fields. | |
15
16
 
@@ -0,0 +1,14 @@
1
+ require "dropbox-sign"
2
+
3
+ Dropbox::Sign.configure do |config|
4
+ # Configure HTTP basic authorization: api_key
5
+ config.username = "YOUR_API_KEY"
6
+ end
7
+
8
+ fax_api = Dropbox::Sign::FaxApi.new
9
+
10
+ begin
11
+ fax_api.fax_delete("fa5c8a0b0f492d768749333ad6fcc214c111e967")
12
+ rescue Dropbox::Sign::ApiError => e
13
+ puts "Exception when calling Dropbox Sign API: #{e}"
14
+ end
@@ -0,0 +1,17 @@
1
+ require "dropbox-sign"
2
+
3
+ Dropbox::Sign.configure do |config|
4
+ # Configure HTTP basic authorization: api_key
5
+ config.username = "YOUR_API_KEY"
6
+ end
7
+
8
+ fax_api = Dropbox::Sign::FaxApi.new
9
+
10
+ faxId = "fa5c8a0b0f492d768749333ad6fcc214c111e967"
11
+
12
+ begin
13
+ file_bin = fax_api.fax_files(data)
14
+ FileUtils.cp(file_bin.path, "path/to/file.pdf")
15
+ rescue Dropbox::Sign::ApiError => e
16
+ puts "Exception when calling Dropbox Sign API: #{e}"
17
+ end
@@ -0,0 +1,17 @@
1
+ require "dropbox-sign"
2
+
3
+ Dropbox::Sign.configure do |config|
4
+ # Configure HTTP basic authorization: api_key
5
+ config.username = "YOUR_API_KEY"
6
+ end
7
+
8
+ fax_api = Dropbox::Sign::FaxApi.new
9
+
10
+ fax_id = "fa5c8a0b0f492d768749333ad6fcc214c111e967"
11
+
12
+ begin
13
+ result = fax_api.fax_get(fax_id)
14
+ p result
15
+ rescue Dropbox::Sign::ApiError => e
16
+ puts "Exception when calling Dropbox Sign API: #{e}"
17
+ end
@@ -0,0 +1,18 @@
1
+ require "dropbox-sign"
2
+
3
+ Dropbox::Sign.configure do |config|
4
+ # Configure HTTP basic authorization: api_key
5
+ config.username = "YOUR_API_KEY"
6
+ end
7
+
8
+ fax_api = Dropbox::Sign::FaxApi.new
9
+
10
+ page = 1
11
+ page_size = 2
12
+
13
+ begin
14
+ result = fax_api.fax_list({ page: page, page_size: page_size })
15
+ p result
16
+ rescue Dropbox::Sign::ApiError => e
17
+ puts "Exception when calling Dropbox Sign API: #{e}"
18
+ end
@@ -0,0 +1,25 @@
1
+ require "dropbox-sign"
2
+
3
+ Dropbox::Sign.configure do |config|
4
+ # Configure HTTP basic authorization: api_key
5
+ config.username = "YOUR_API_KEY"
6
+ end
7
+
8
+ fax_api = Dropbox::Sign::FaxApi.new
9
+
10
+ data = Dropbox::Sign::FaxSendRequest.new
11
+ data.files = [File.new("example_signature_request.pdf", "r")]
12
+ data.test_mode = true
13
+ data.recipient = "16690000001"
14
+ data.sender = "16690000000"
15
+ data.cover_page_to = "Jill Fax"
16
+ data.cover_page_message = "I'm sending you a fax!"
17
+ data.cover_page_from = "Faxer Faxerson"
18
+ data.title = "This is what the fax is about!"
19
+
20
+ begin
21
+ result = fax_api.fax_send(data)
22
+ p result
23
+ rescue Dropbox::Sign::ApiError => e
24
+ puts "Exception when calling Dropbox Sign API: #{e}"
25
+ end