tca_client 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +3 -3
  3. data/docs/AddGroupAttachmentRequest.md +16 -4
  4. data/docs/AddGroupAttachmentResponse.md +14 -3
  5. data/docs/AggregateGroup.md +24 -8
  6. data/docs/AnnotationsSettings.md +18 -0
  7. data/docs/AuthorMetadataOverride.md +16 -4
  8. data/docs/EULAApi.md +166 -92
  9. data/docs/Error.md +16 -4
  10. data/docs/Eula.md +18 -5
  11. data/docs/EulaAcceptListItem.md +20 -6
  12. data/docs/EulaAcceptRequest.md +20 -6
  13. data/docs/EulaVersion.md +22 -7
  14. data/docs/FeaturesApi.md +41 -23
  15. data/docs/FeaturesEnabled.md +20 -6
  16. data/docs/FeaturesGenerationSettings.md +16 -4
  17. data/docs/FeaturesSimilarity.md +18 -5
  18. data/docs/FeaturesSimilarityViewSettings.md +38 -15
  19. data/docs/FeaturesTenant.md +14 -3
  20. data/docs/FeaturesViewerModes.md +16 -4
  21. data/docs/GenerateSimilarityPDF.md +18 -0
  22. data/docs/GetGroupAttachments200Response.md +18 -0
  23. data/docs/Group.md +18 -5
  24. data/docs/GroupAttachmentResponse.md +20 -6
  25. data/docs/GroupContext.md +18 -5
  26. data/docs/GroupsApi.md +321 -177
  27. data/docs/IndexApi.md +84 -44
  28. data/docs/IndexStateSettings.md +14 -3
  29. data/docs/IndexingSettings.md +14 -3
  30. data/docs/PDFStatusWebhookRequest.md +24 -0
  31. data/docs/PdfStatusResponse.md +14 -3
  32. data/docs/RateLimitError.md +16 -4
  33. data/docs/RequestPdfResponse.md +14 -3
  34. data/docs/Sidebar.md +14 -3
  35. data/docs/SimilarityApi.md +239 -129
  36. data/docs/SimilarityCompleteWebhookRequest.md +38 -0
  37. data/docs/SimilarityGenerationSettings.md +20 -6
  38. data/docs/SimilarityMetadata.md +32 -12
  39. data/docs/SimilarityMetadataAllOf.md +28 -0
  40. data/docs/SimilarityMetadataAllOfTopMatches.md +30 -0
  41. data/docs/SimilarityPutRequest.md +18 -5
  42. data/docs/SimilarityScoreData.md +20 -6
  43. data/docs/SimilaritySettings.md +18 -5
  44. data/docs/SimilaritySettingsModes.md +16 -4
  45. data/docs/SimilaritySettingsViewSettings.md +14 -3
  46. data/docs/SimilarityViewSettings.md +38 -15
  47. data/docs/SimilarityViewerUrlResponse.md +14 -3
  48. data/docs/SimilarityViewerUrlSettings.md +30 -10
  49. data/docs/SimpleSubmissionResponse.md +22 -2
  50. data/docs/SimpleSubmissionResponseAllOf.md +26 -0
  51. data/docs/Submission.md +34 -2
  52. data/docs/SubmissionAllOf.md +38 -0
  53. data/docs/SubmissionApi.md +203 -112
  54. data/docs/SubmissionBase.md +30 -11
  55. data/docs/SubmissionBaseMetadata.md +24 -8
  56. data/docs/SubmissionCompleteWebhookRequest.md +40 -0
  57. data/docs/SubmissionCompleteWebhookRequestAllOf.md +18 -0
  58. data/docs/SubmissionCompleteWebhookRequestAllOfMetadata.md +18 -0
  59. data/docs/SubmissionSizeError.md +16 -4
  60. data/docs/SuccessMessage.md +14 -3
  61. data/docs/Users.md +20 -6
  62. data/docs/ViewerPermissions.md +22 -7
  63. data/docs/Webhook.md +24 -6
  64. data/docs/WebhookAllOf.md +20 -0
  65. data/docs/WebhookApi.md +193 -103
  66. data/docs/WebhookBase.md +20 -6
  67. data/docs/WebhookPathRequest.md +16 -4
  68. data/docs/WebhookWithSecret.md +22 -6
  69. data/docs/WebhookWithSecretAllOf.md +18 -0
  70. data/lib/tca_client/api/eula_api.rb +96 -63
  71. data/lib/tca_client/api/features_api.rb +21 -12
  72. data/lib/tca_client/api/groups_api.rb +225 -155
  73. data/lib/tca_client/api/index_api.rb +46 -27
  74. data/lib/tca_client/api/similarity_api.rb +165 -104
  75. data/lib/tca_client/api/submission_api.rb +140 -97
  76. data/lib/tca_client/api/webhook_api.rb +120 -77
  77. data/lib/tca_client/api_client.rb +61 -57
  78. data/lib/tca_client/api_error.rb +4 -4
  79. data/lib/tca_client/configuration.rb +93 -13
  80. data/lib/tca_client/models/add_group_attachment_request.rb +50 -13
  81. data/lib/tca_client/models/add_group_attachment_response.rb +25 -12
  82. data/lib/tca_client/models/aggregate_group.rb +34 -21
  83. data/lib/tca_client/models/annotations_settings.rb +220 -0
  84. data/lib/tca_client/models/author_metadata_override.rb +26 -13
  85. data/lib/tca_client/models/error.rb +26 -13
  86. data/lib/tca_client/models/eula.rb +27 -14
  87. data/lib/tca_client/models/eula_accept_list_item.rb +28 -15
  88. data/lib/tca_client/models/eula_accept_request.rb +28 -15
  89. data/lib/tca_client/models/eula_version.rb +29 -16
  90. data/lib/tca_client/models/features_enabled.rb +28 -15
  91. data/lib/tca_client/models/features_generation_settings.rb +26 -13
  92. data/lib/tca_client/models/features_similarity.rb +27 -14
  93. data/lib/tca_client/models/features_similarity_view_settings.rb +37 -24
  94. data/lib/tca_client/models/features_tenant.rb +25 -12
  95. data/lib/tca_client/models/features_viewer_modes.rb +26 -13
  96. data/lib/tca_client/models/generate_similarity_pdf.rb +254 -0
  97. data/lib/tca_client/models/{inline_response_200.rb → get_group_attachments200_response.rb} +28 -15
  98. data/lib/tca_client/models/group.rb +29 -16
  99. data/lib/tca_client/models/group_attachment_response.rb +38 -17
  100. data/lib/tca_client/models/group_context.rb +27 -14
  101. data/lib/tca_client/models/index_state_settings.rb +25 -12
  102. data/lib/tca_client/models/indexing_settings.rb +25 -12
  103. data/lib/tca_client/models/pdf_status_response.rb +27 -14
  104. data/lib/tca_client/models/pdf_status_webhook_request.rb +283 -0
  105. data/lib/tca_client/models/rate_limit_error.rb +36 -20
  106. data/lib/tca_client/models/request_pdf_response.rb +25 -12
  107. data/lib/tca_client/models/sidebar.rb +27 -14
  108. data/lib/tca_client/models/similarity_complete_webhook_request.rb +366 -0
  109. data/lib/tca_client/models/similarity_generation_settings.rb +30 -17
  110. data/lib/tca_client/models/similarity_metadata.rb +45 -28
  111. data/lib/tca_client/models/similarity_metadata_all_of.rb +301 -0
  112. data/lib/tca_client/models/{similarity_metadata_top_matches.rb → similarity_metadata_all_of_top_matches.rb} +34 -21
  113. data/lib/tca_client/models/similarity_put_request.rb +27 -14
  114. data/lib/tca_client/models/similarity_score_data.rb +28 -15
  115. data/lib/tca_client/models/similarity_settings.rb +29 -16
  116. data/lib/tca_client/models/similarity_settings_modes.rb +26 -13
  117. data/lib/tca_client/models/similarity_settings_view_settings.rb +25 -12
  118. data/lib/tca_client/models/similarity_view_settings.rb +37 -24
  119. data/lib/tca_client/models/similarity_viewer_url_response.rb +25 -12
  120. data/lib/tca_client/models/similarity_viewer_url_settings.rb +46 -24
  121. data/lib/tca_client/models/simple_submission_response.rb +117 -13
  122. data/lib/tca_client/models/simple_submission_response_all_of.rb +294 -0
  123. data/lib/tca_client/models/submission.rb +191 -13
  124. data/lib/tca_client/models/submission_all_of.rb +368 -0
  125. data/lib/tca_client/models/submission_base.rb +82 -23
  126. data/lib/tca_client/models/submission_base_metadata.rb +30 -17
  127. data/lib/tca_client/models/submission_complete_webhook_request.rb +385 -0
  128. data/lib/tca_client/models/submission_complete_webhook_request_all_of.rb +219 -0
  129. data/lib/tca_client/models/submission_complete_webhook_request_all_of_metadata.rb +219 -0
  130. data/lib/tca_client/models/submission_size_error.rb +36 -20
  131. data/lib/tca_client/models/success_message.rb +25 -12
  132. data/lib/tca_client/models/users.rb +28 -15
  133. data/lib/tca_client/models/viewer_permissions.rb +29 -16
  134. data/lib/tca_client/models/webhook.rb +62 -16
  135. data/lib/tca_client/models/webhook_all_of.rb +235 -0
  136. data/lib/tca_client/models/webhook_base.rb +28 -15
  137. data/lib/tca_client/models/webhook_path_request.rb +26 -13
  138. data/lib/tca_client/models/webhook_with_secret.rb +52 -16
  139. data/lib/tca_client/models/webhook_with_secret_all_of.rb +225 -0
  140. data/lib/tca_client/version.rb +5 -4
  141. data/lib/tca_client.rb +18 -5
  142. data/spec/api/submission_api_spec.rb +2 -2
  143. data/tca_client-1.0.0.gem +0 -0
  144. data/tca_client-1.0.1.gem +0 -0
  145. data/tca_client.gemspec +7 -7
  146. metadata +44 -38
  147. data/docs/InlineResponse200.md +0 -7
  148. data/docs/SimilarityMetadataTopMatches.md +0 -13
@@ -1,54 +1,74 @@
1
1
  # TCAClient::SubmissionApi
2
2
 
3
- All URIs are relative to *https://{tenantName}.{hostName}/api/v1*
3
+ All URIs are relative to *https://app-us.turnitin.com/api/v1*
4
4
 
5
- Method | HTTP request | Description
6
- ------------- | ------------- | -------------
7
- [**create_submission**](SubmissionApi.md#create_submission) | **POST** /submissions | Create a new Submission
8
- [**delete_submission**](SubmissionApi.md#delete_submission) | **DELETE** /submissions/{id} | Deletes a submission and associated similarity report.
9
- [**get_submiddion_details**](SubmissionApi.md#get_submiddion_details) | **GET** /submissions/{id} | Get Submission Details
10
- [**recover_submission**](SubmissionApi.md#recover_submission) | **PUT** /submissions/{id}/recover | Recover a soft deleted submission
11
- [**upload_submitted_file**](SubmissionApi.md#upload_submitted_file) | **PUT** /submissions/{id}/original | Upload Submitted File
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**create_submission**](SubmissionApi.md#create_submission) | **POST** /submissions | Create a new Submission |
8
+ | [**delete_submission**](SubmissionApi.md#delete_submission) | **DELETE** /submissions/{id} | Deletes a submission and associated similarity report. |
9
+ | [**get_submission_details**](SubmissionApi.md#get_submission_details) | **GET** /submissions/{id} | Get Submission Details |
10
+ | [**recover_submission**](SubmissionApi.md#recover_submission) | **PUT** /submissions/{id}/recover | Recover a soft deleted submission |
11
+ | [**upload_submitted_file**](SubmissionApi.md#upload_submitted_file) | **PUT** /submissions/{id}/original | Upload Submitted File |
12
12
 
13
- # **create_submission**
14
- > SimpleSubmissionResponse create_submission(bodyx_turnitin_integration_namex_turnitin_integration_version)
13
+
14
+ ## create_submission
15
+
16
+ > <SimpleSubmissionResponse> create_submission(x_turnitin_integration_name, x_turnitin_integration_version, data)
15
17
 
16
18
  Create a new Submission
17
19
 
18
- ### Example
20
+ ### Examples
21
+
19
22
  ```ruby
20
- # load the gem
23
+ require 'time'
21
24
  require 'tca_client'
22
25
  # setup authorization
23
26
  TCAClient.configure do |config|
24
27
  # Configure API key authorization: api_key
25
- config.api_key['Authorization'] = 'YOUR API KEY'
28
+ config.api_key['api_key'] = 'YOUR API KEY'
26
29
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
27
- #config.api_key_prefix['Authorization'] = 'Bearer'
30
+ # config.api_key_prefix['api_key'] = 'Bearer'
28
31
  end
29
32
 
30
33
  api_instance = TCAClient::SubmissionApi.new
31
- body = TCAClient::SubmissionBase.new # SubmissionBase |
32
- x_turnitin_integration_name = 'x_turnitin_integration_name_example' # String | a human readable string representing the type of integration being used
33
- x_turnitin_integration_version = 'x_turnitin_integration_version_example' # String | the version of the integration platform being used
34
-
34
+ x_turnitin_integration_name = 'myintegration' # String | a human readable string representing the type of integration being used
35
+ x_turnitin_integration_version = 'v1.0.2' # String | the version of the integration platform being used
36
+ data = TCAClient::SubmissionBase.new # SubmissionBase |
35
37
 
36
38
  begin
37
- #Create a new Submission
38
- result = api_instance.create_submission(bodyx_turnitin_integration_namex_turnitin_integration_version)
39
+ # Create a new Submission
40
+ result = api_instance.create_submission(x_turnitin_integration_name, x_turnitin_integration_version, data)
39
41
  p result
40
42
  rescue TCAClient::ApiError => e
41
- puts "Exception when calling SubmissionApi->create_submission: #{e}"
43
+ puts "Error when calling SubmissionApi->create_submission: #{e}"
44
+ end
45
+ ```
46
+
47
+ #### Using the create_submission_with_http_info variant
48
+
49
+ This returns an Array which contains the response data, status code and headers.
50
+
51
+ > <Array(<SimpleSubmissionResponse>, Integer, Hash)> create_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, data)
52
+
53
+ ```ruby
54
+ begin
55
+ # Create a new Submission
56
+ data, status_code, headers = api_instance.create_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, data)
57
+ p status_code # => 2xx
58
+ p headers # => { ... }
59
+ p data # => <SimpleSubmissionResponse>
60
+ rescue TCAClient::ApiError => e
61
+ puts "Error when calling SubmissionApi->create_submission_with_http_info: #{e}"
42
62
  end
43
63
  ```
44
64
 
45
65
  ### Parameters
46
66
 
47
- Name | Type | Description | Notes
48
- ------------- | ------------- | ------------- | -------------
49
- **body** | [**SubmissionBase**](SubmissionBase.md)| |
50
- **x_turnitin_integration_name** | **String**| a human readable string representing the type of integration being used |
51
- **x_turnitin_integration_version** | **String**| the version of the integration platform being used |
67
+ | Name | Type | Description | Notes |
68
+ | ---- | ---- | ----------- | ----- |
69
+ | **x_turnitin_integration_name** | **String** | a human readable string representing the type of integration being used | |
70
+ | **x_turnitin_integration_version** | **String** | the version of the integration platform being used | |
71
+ | **data** | [**SubmissionBase**](SubmissionBase.md) | | |
52
72
 
53
73
  ### Return type
54
74
 
@@ -60,53 +80,72 @@ Name | Type | Description | Notes
60
80
 
61
81
  ### HTTP request headers
62
82
 
63
- - **Content-Type**: application/json
64
- - **Accept**: application/json
83
+ - **Content-Type**: application/json
84
+ - **Accept**: application/json
65
85
 
66
86
 
87
+ ## delete_submission
67
88
 
68
- # **delete_submission**
69
- > SuccessMessage delete_submission(x_turnitin_integration_name, x_turnitin_integration_version, id, opts)
89
+ > <SuccessMessage> delete_submission(x_turnitin_integration_name, x_turnitin_integration_version, id, opts)
70
90
 
71
91
  Deletes a submission and associated similarity report.
72
92
 
73
- ### Example
93
+ ### Examples
94
+
74
95
  ```ruby
75
- # load the gem
96
+ require 'time'
76
97
  require 'tca_client'
77
98
  # setup authorization
78
99
  TCAClient.configure do |config|
79
100
  # Configure API key authorization: api_key
80
- config.api_key['Authorization'] = 'YOUR API KEY'
101
+ config.api_key['api_key'] = 'YOUR API KEY'
81
102
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
82
- #config.api_key_prefix['Authorization'] = 'Bearer'
103
+ # config.api_key_prefix['api_key'] = 'Bearer'
83
104
  end
84
105
 
85
106
  api_instance = TCAClient::SubmissionApi.new
86
- x_turnitin_integration_name = 'x_turnitin_integration_name_example' # String | a human readable string representing the type of integration being used
87
- x_turnitin_integration_version = 'x_turnitin_integration_version_example' # String | the version of the integration platform being used
107
+ x_turnitin_integration_name = 'myintegration' # String | a human readable string representing the type of integration being used
108
+ x_turnitin_integration_version = 'v1.0.2' # String | the version of the integration platform being used
88
109
  id = 'id_example' # String | The Submission ID (returned upon a successful POST to /submissions)
89
- opts = {
90
- hard: 'false' # String | Accepts true or false indicating either hard or soft delete. A soft delete removes the associated submission report/index and changes the saved submission state to DELETED. A hard deletion completely removes the submission information from Panda and TCA and removes the associated report/index, which can not be recovered.
110
+ opts = {
111
+ hard: 'hard_example' # String | Accepts true or false indicating either hard or soft delete. A soft delete removes the associated submission report/index and changes the saved submission state to DELETED. A hard deletion completely removes the submission information from Panda and TCA and removes the associated report/index, which can not be recovered.
91
112
  }
92
113
 
93
114
  begin
94
- #Deletes a submission and associated similarity report.
115
+ # Deletes a submission and associated similarity report.
95
116
  result = api_instance.delete_submission(x_turnitin_integration_name, x_turnitin_integration_version, id, opts)
96
117
  p result
97
118
  rescue TCAClient::ApiError => e
98
- puts "Exception when calling SubmissionApi->delete_submission: #{e}"
119
+ puts "Error when calling SubmissionApi->delete_submission: #{e}"
120
+ end
121
+ ```
122
+
123
+ #### Using the delete_submission_with_http_info variant
124
+
125
+ This returns an Array which contains the response data, status code and headers.
126
+
127
+ > <Array(<SuccessMessage>, Integer, Hash)> delete_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id, opts)
128
+
129
+ ```ruby
130
+ begin
131
+ # Deletes a submission and associated similarity report.
132
+ data, status_code, headers = api_instance.delete_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id, opts)
133
+ p status_code # => 2xx
134
+ p headers # => { ... }
135
+ p data # => <SuccessMessage>
136
+ rescue TCAClient::ApiError => e
137
+ puts "Error when calling SubmissionApi->delete_submission_with_http_info: #{e}"
99
138
  end
100
139
  ```
101
140
 
102
141
  ### Parameters
103
142
 
104
- Name | Type | Description | Notes
105
- ------------- | ------------- | ------------- | -------------
106
- **x_turnitin_integration_name** | **String**| a human readable string representing the type of integration being used |
107
- **x_turnitin_integration_version** | **String**| the version of the integration platform being used |
108
- **id** | **String**| The Submission ID (returned upon a successful POST to /submissions) |
109
- **hard** | **String**| Accepts true or false indicating either hard or soft delete. A soft delete removes the associated submission report/index and changes the saved submission state to DELETED. A hard deletion completely removes the submission information from Panda and TCA and removes the associated report/index, which can not be recovered. | [optional] [default to false]
143
+ | Name | Type | Description | Notes |
144
+ | ---- | ---- | ----------- | ----- |
145
+ | **x_turnitin_integration_name** | **String** | a human readable string representing the type of integration being used | |
146
+ | **x_turnitin_integration_version** | **String** | the version of the integration platform being used | |
147
+ | **id** | **String** | The Submission ID (returned upon a successful POST to /submissions) | |
148
+ | **hard** | **String** | Accepts true or false indicating either hard or soft delete. A soft delete removes the associated submission report/index and changes the saved submission state to DELETED. A hard deletion completely removes the submission information from Panda and TCA and removes the associated report/index, which can not be recovered. | [optional][default to &#39;false&#39;] |
110
149
 
111
150
  ### Return type
112
151
 
@@ -118,50 +157,68 @@ Name | Type | Description | Notes
118
157
 
119
158
  ### HTTP request headers
120
159
 
121
- - **Content-Type**: Not defined
122
- - **Accept**: application/json
160
+ - **Content-Type**: Not defined
161
+ - **Accept**: application/json
123
162
 
124
163
 
164
+ ## get_submission_details
125
165
 
126
- # **get_submiddion_details**
127
- > Submission get_submiddion_details(x_turnitin_integration_name, x_turnitin_integration_version, id)
166
+ > <Submission> get_submission_details(x_turnitin_integration_name, x_turnitin_integration_version, id)
128
167
 
129
168
  Get Submission Details
130
169
 
131
- ### Example
170
+ ### Examples
171
+
132
172
  ```ruby
133
- # load the gem
173
+ require 'time'
134
174
  require 'tca_client'
135
175
  # setup authorization
136
176
  TCAClient.configure do |config|
137
177
  # Configure API key authorization: api_key
138
- config.api_key['Authorization'] = 'YOUR API KEY'
178
+ config.api_key['api_key'] = 'YOUR API KEY'
139
179
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
140
- #config.api_key_prefix['Authorization'] = 'Bearer'
180
+ # config.api_key_prefix['api_key'] = 'Bearer'
141
181
  end
142
182
 
143
183
  api_instance = TCAClient::SubmissionApi.new
144
- x_turnitin_integration_name = 'x_turnitin_integration_name_example' # String | a human readable string representing the type of integration being used
145
- x_turnitin_integration_version = 'x_turnitin_integration_version_example' # String | the version of the integration platform being used
184
+ x_turnitin_integration_name = 'myintegration' # String | a human readable string representing the type of integration being used
185
+ x_turnitin_integration_version = 'v1.0.2' # String | the version of the integration platform being used
146
186
  id = 'id_example' # String | The Submission ID (returned upon a successful POST to /submissions)
147
187
 
148
-
149
188
  begin
150
- #Get Submission Details
151
- result = api_instance.get_submiddion_details(x_turnitin_integration_name, x_turnitin_integration_version, id)
189
+ # Get Submission Details
190
+ result = api_instance.get_submission_details(x_turnitin_integration_name, x_turnitin_integration_version, id)
152
191
  p result
153
192
  rescue TCAClient::ApiError => e
154
- puts "Exception when calling SubmissionApi->get_submiddion_details: #{e}"
193
+ puts "Error when calling SubmissionApi->get_submission_details: #{e}"
194
+ end
195
+ ```
196
+
197
+ #### Using the get_submission_details_with_http_info variant
198
+
199
+ This returns an Array which contains the response data, status code and headers.
200
+
201
+ > <Array(<Submission>, Integer, Hash)> get_submission_details_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id)
202
+
203
+ ```ruby
204
+ begin
205
+ # Get Submission Details
206
+ data, status_code, headers = api_instance.get_submission_details_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id)
207
+ p status_code # => 2xx
208
+ p headers # => { ... }
209
+ p data # => <Submission>
210
+ rescue TCAClient::ApiError => e
211
+ puts "Error when calling SubmissionApi->get_submission_details_with_http_info: #{e}"
155
212
  end
156
213
  ```
157
214
 
158
215
  ### Parameters
159
216
 
160
- Name | Type | Description | Notes
161
- ------------- | ------------- | ------------- | -------------
162
- **x_turnitin_integration_name** | **String**| a human readable string representing the type of integration being used |
163
- **x_turnitin_integration_version** | **String**| the version of the integration platform being used |
164
- **id** | **String**| The Submission ID (returned upon a successful POST to /submissions) |
217
+ | Name | Type | Description | Notes |
218
+ | ---- | ---- | ----------- | ----- |
219
+ | **x_turnitin_integration_name** | **String** | a human readable string representing the type of integration being used | |
220
+ | **x_turnitin_integration_version** | **String** | the version of the integration platform being used | |
221
+ | **id** | **String** | The Submission ID (returned upon a successful POST to /submissions) | |
165
222
 
166
223
  ### Return type
167
224
 
@@ -173,50 +230,68 @@ Name | Type | Description | Notes
173
230
 
174
231
  ### HTTP request headers
175
232
 
176
- - **Content-Type**: Not defined
177
- - **Accept**: application/json
233
+ - **Content-Type**: Not defined
234
+ - **Accept**: application/json
178
235
 
179
236
 
237
+ ## recover_submission
180
238
 
181
- # **recover_submission**
182
- > SimpleSubmissionResponse recover_submission(x_turnitin_integration_name, x_turnitin_integration_version, id)
239
+ > <SimpleSubmissionResponse> recover_submission(x_turnitin_integration_name, x_turnitin_integration_version, id)
183
240
 
184
241
  Recover a soft deleted submission
185
242
 
186
- ### Example
243
+ ### Examples
244
+
187
245
  ```ruby
188
- # load the gem
246
+ require 'time'
189
247
  require 'tca_client'
190
248
  # setup authorization
191
249
  TCAClient.configure do |config|
192
250
  # Configure API key authorization: api_key
193
- config.api_key['Authorization'] = 'YOUR API KEY'
251
+ config.api_key['api_key'] = 'YOUR API KEY'
194
252
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
195
- #config.api_key_prefix['Authorization'] = 'Bearer'
253
+ # config.api_key_prefix['api_key'] = 'Bearer'
196
254
  end
197
255
 
198
256
  api_instance = TCAClient::SubmissionApi.new
199
- x_turnitin_integration_name = 'x_turnitin_integration_name_example' # String | a human readable string representing the type of integration being used
200
- x_turnitin_integration_version = 'x_turnitin_integration_version_example' # String | the version of the integration platform being used
257
+ x_turnitin_integration_name = 'myintegration' # String | a human readable string representing the type of integration being used
258
+ x_turnitin_integration_version = 'v1.0.2' # String | the version of the integration platform being used
201
259
  id = 'id_example' # String | The Submission ID (returned upon a successful POST to /submissions)
202
260
 
203
-
204
261
  begin
205
- #Recover a soft deleted submission
262
+ # Recover a soft deleted submission
206
263
  result = api_instance.recover_submission(x_turnitin_integration_name, x_turnitin_integration_version, id)
207
264
  p result
208
265
  rescue TCAClient::ApiError => e
209
- puts "Exception when calling SubmissionApi->recover_submission: #{e}"
266
+ puts "Error when calling SubmissionApi->recover_submission: #{e}"
267
+ end
268
+ ```
269
+
270
+ #### Using the recover_submission_with_http_info variant
271
+
272
+ This returns an Array which contains the response data, status code and headers.
273
+
274
+ > <Array(<SimpleSubmissionResponse>, Integer, Hash)> recover_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id)
275
+
276
+ ```ruby
277
+ begin
278
+ # Recover a soft deleted submission
279
+ data, status_code, headers = api_instance.recover_submission_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id)
280
+ p status_code # => 2xx
281
+ p headers # => { ... }
282
+ p data # => <SimpleSubmissionResponse>
283
+ rescue TCAClient::ApiError => e
284
+ puts "Error when calling SubmissionApi->recover_submission_with_http_info: #{e}"
210
285
  end
211
286
  ```
212
287
 
213
288
  ### Parameters
214
289
 
215
- Name | Type | Description | Notes
216
- ------------- | ------------- | ------------- | -------------
217
- **x_turnitin_integration_name** | **String**| a human readable string representing the type of integration being used |
218
- **x_turnitin_integration_version** | **String**| the version of the integration platform being used |
219
- **id** | **String**| The Submission ID (returned upon a successful POST to /submissions) |
290
+ | Name | Type | Description | Notes |
291
+ | ---- | ---- | ----------- | ----- |
292
+ | **x_turnitin_integration_name** | **String** | a human readable string representing the type of integration being used | |
293
+ | **x_turnitin_integration_version** | **String** | the version of the integration platform being used | |
294
+ | **id** | **String** | The Submission ID (returned upon a successful POST to /submissions) | |
220
295
 
221
296
  ### Return type
222
297
 
@@ -228,56 +303,74 @@ Name | Type | Description | Notes
228
303
 
229
304
  ### HTTP request headers
230
305
 
231
- - **Content-Type**: Not defined
232
- - **Accept**: application/json
306
+ - **Content-Type**: Not defined
307
+ - **Accept**: application/json
233
308
 
234
309
 
310
+ ## upload_submitted_file
235
311
 
236
- # **upload_submitted_file**
237
- > SuccessMessage upload_submitted_file(bodyx_turnitin_integration_namex_turnitin_integration_versioncontent_typecontent_dispositionid)
312
+ > <SuccessMessage> upload_submitted_file(x_turnitin_integration_name, x_turnitin_integration_version, id, content_type, content_disposition, file)
238
313
 
239
314
  Upload Submitted File
240
315
 
241
- ### Example
316
+ ### Examples
317
+
242
318
  ```ruby
243
- # load the gem
319
+ require 'time'
244
320
  require 'tca_client'
245
321
  # setup authorization
246
322
  TCAClient.configure do |config|
247
323
  # Configure API key authorization: api_key
248
- config.api_key['Authorization'] = 'YOUR API KEY'
324
+ config.api_key['api_key'] = 'YOUR API KEY'
249
325
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
250
- #config.api_key_prefix['Authorization'] = 'Bearer'
326
+ # config.api_key_prefix['api_key'] = 'Bearer'
251
327
  end
252
328
 
253
329
  api_instance = TCAClient::SubmissionApi.new
254
- body = nil # Object | the user's submitted file
255
- x_turnitin_integration_name = 'x_turnitin_integration_name_example' # String | a human readable string representing the type of integration being used
256
- x_turnitin_integration_version = 'x_turnitin_integration_version_example' # String | the version of the integration platform being used
257
- content_type = 'content_type_example' # String | *Must be 'binary/octet-stream'
258
- content_disposition = 'content_disposition_example' # String | *must include the \"filename\" parameter, e.g. `inline; filename=\"MyFile.docx\"`. To support UTF-8 filenames, you must URL encode the header
330
+ x_turnitin_integration_name = 'myintegration' # String | a human readable string representing the type of integration being used
331
+ x_turnitin_integration_version = 'v1.0.2' # String | the version of the integration platform being used
259
332
  id = 'id_example' # String | The Submission ID (returned upon a successful POST to /submissions)
260
-
333
+ content_type = 'content_type_example' # String | *Must be 'binary/octet-stream'
334
+ content_disposition = 'inline; filename="MyFile.docx"' # String | *must include the \"filename\" parameter, e.g. `inline; filename=\"MyFile.docx\"`. To support UTF-8 filenames, you must URL encode the header
335
+ file = { ... } # Object | the user's submitted file
261
336
 
262
337
  begin
263
- #Upload Submitted File
264
- result = api_instance.upload_submitted_file(bodyx_turnitin_integration_namex_turnitin_integration_versioncontent_typecontent_dispositionid)
338
+ # Upload Submitted File
339
+ result = api_instance.upload_submitted_file(x_turnitin_integration_name, x_turnitin_integration_version, id, content_type, content_disposition, file)
265
340
  p result
266
341
  rescue TCAClient::ApiError => e
267
- puts "Exception when calling SubmissionApi->upload_submitted_file: #{e}"
342
+ puts "Error when calling SubmissionApi->upload_submitted_file: #{e}"
343
+ end
344
+ ```
345
+
346
+ #### Using the upload_submitted_file_with_http_info variant
347
+
348
+ This returns an Array which contains the response data, status code and headers.
349
+
350
+ > <Array(<SuccessMessage>, Integer, Hash)> upload_submitted_file_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id, content_type, content_disposition, file)
351
+
352
+ ```ruby
353
+ begin
354
+ # Upload Submitted File
355
+ data, status_code, headers = api_instance.upload_submitted_file_with_http_info(x_turnitin_integration_name, x_turnitin_integration_version, id, content_type, content_disposition, file)
356
+ p status_code # => 2xx
357
+ p headers # => { ... }
358
+ p data # => <SuccessMessage>
359
+ rescue TCAClient::ApiError => e
360
+ puts "Error when calling SubmissionApi->upload_submitted_file_with_http_info: #{e}"
268
361
  end
269
362
  ```
270
363
 
271
364
  ### Parameters
272
365
 
273
- Name | Type | Description | Notes
274
- ------------- | ------------- | ------------- | -------------
275
- **body** | [**Object**](Object.md)| the user&#x27;s submitted file |
276
- **x_turnitin_integration_name** | **String**| a human readable string representing the type of integration being used |
277
- **x_turnitin_integration_version** | **String**| the version of the integration platform being used |
278
- **content_type** | **String**| *Must be &#x27;binary/octet-stream&#x27; |
279
- **content_disposition** | **String**| *must include the \&quot;filename\&quot; parameter, e.g. &#x60;inline; filename&#x3D;\&quot;MyFile.docx\&quot;&#x60;. To support UTF-8 filenames, you must URL encode the header |
280
- **id** | **String**| The Submission ID (returned upon a successful POST to /submissions) |
366
+ | Name | Type | Description | Notes |
367
+ | ---- | ---- | ----------- | ----- |
368
+ | **x_turnitin_integration_name** | **String** | a human readable string representing the type of integration being used | |
369
+ | **x_turnitin_integration_version** | **String** | the version of the integration platform being used | |
370
+ | **id** | **String** | The Submission ID (returned upon a successful POST to /submissions) | |
371
+ | **content_type** | **String** | *Must be &#39;binary/octet-stream&#39; | |
372
+ | **content_disposition** | **String** | *must include the \&quot;filename\&quot; parameter, e.g. &#x60;inline; filename&#x3D;\&quot;MyFile.docx\&quot;&#x60;. To support UTF-8 filenames, you must URL encode the header | |
373
+ | **file** | **Object** | the user&#39;s submitted file | |
281
374
 
282
375
  ### Return type
283
376
 
@@ -289,8 +382,6 @@ Name | Type | Description | Notes
289
382
 
290
383
  ### HTTP request headers
291
384
 
292
- - **Content-Type**: binary/octet-stream
293
- - **Accept**: application/json
294
-
295
-
385
+ - **Content-Type**: binary/octet-stream
386
+ - **Accept**: application/json
296
387
 
@@ -1,15 +1,34 @@
1
1
  # TCAClient::SubmissionBase
2
2
 
3
3
  ## Properties
4
- Name | Type | Description | Notes
5
- ------------ | ------------- | ------------- | -------------
6
- **id** | [****](.md) | Submission id, optional field | [optional]
7
- **owner** | **String** | ID of the owning user | [optional]
8
- **owner_default_permission_set** | **String** | Default viewer permission set, accepts INSTRUCTOR, LEARNER, EDITOR, USER, APPLICANT, ADMINISTRATOR, UNDEFINED | [optional]
9
- **title** | **String** | the title of the submission | [optional]
10
- **submitter** | **String** | (optional) ID of the submitting user, if different from the owning user | [optional]
11
- **submitter_default_permission_set** | **String** | Default submitter permission set, accepts INSTRUCTOR, LEARNER, EDITOR, USER, APPLICANT, ADMINISTRATOR, UNDEFINED | [optional]
12
- **eula** | [**Eula**](Eula.md) | | [optional]
13
- **metadata** | [**SubmissionBaseMetadata**](SubmissionBaseMetadata.md) | | [optional]
14
- **extract_text_only** | **BOOLEAN** | (optional) indicates if the submission should be treated as a text only submission. A text only submission cannot generate full reports or be viewed in the viewer, but can use the index only endpoint to be indexed | [optional]
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **id** | **Object** | Submission id, optional field | [optional] |
8
+ | **owner** | **String** | ID of the owning user | [optional] |
9
+ | **owner_default_permission_set** | **String** | Default viewer permission set, accepts INSTRUCTOR, LEARNER, EDITOR, USER, APPLICANT, ADMINISTRATOR, UNDEFINED | [optional] |
10
+ | **title** | **String** | the title of the submission | [optional] |
11
+ | **submitter** | **String** | (optional) ID of the submitting user, if different from the owning user | [optional] |
12
+ | **submitter_default_permission_set** | **String** | Default submitter permission set, accepts INSTRUCTOR, LEARNER, EDITOR, USER, APPLICANT, ADMINISTRATOR, UNDEFINED | [optional] |
13
+ | **eula** | [**Eula**](Eula.md) | | [optional] |
14
+ | **metadata** | [**SubmissionBaseMetadata**](SubmissionBaseMetadata.md) | | [optional] |
15
+ | **extract_text_only** | **Boolean** | (optional) indicates if the submission should be treated as a text only submission. A text only submission cannot generate full reports or be viewed in the viewer, but can use the index only endpoint to be indexed | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'tca_client'
21
+
22
+ instance = TCAClient::SubmissionBase.new(
23
+ id: null,
24
+ owner: null,
25
+ owner_default_permission_set: null,
26
+ title: null,
27
+ submitter: null,
28
+ submitter_default_permission_set: null,
29
+ eula: null,
30
+ metadata: null,
31
+ extract_text_only: null
32
+ )
33
+ ```
15
34
 
@@ -1,12 +1,28 @@
1
1
  # TCAClient::SubmissionBaseMetadata
2
2
 
3
3
  ## Properties
4
- Name | Type | Description | Notes
5
- ------------ | ------------- | ------------- | -------------
6
- **submitter** | [**Users**](Users.md) | | [optional]
7
- **owners** | [**Array&lt;Users&gt;**](Users.md) | | [optional]
8
- **group** | [**Group**](Group.md) | | [optional]
9
- **group_context** | [**GroupContext**](GroupContext.md) | | [optional]
10
- **original_submitted_time** | **DateTime** | Optional original submision date | [optional]
11
- **custom** | **String** | custom metadata | [optional]
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **submitter** | [**Users**](Users.md) | | [optional] |
8
+ | **owners** | [**Array&lt;Users&gt;**](Users.md) | | [optional] |
9
+ | **group** | [**Group**](Group.md) | | [optional] |
10
+ | **group_context** | [**GroupContext**](GroupContext.md) | | [optional] |
11
+ | **original_submitted_time** | **Time** | Optional original submision date | [optional] |
12
+ | **custom** | **String** | custom metadata | [optional] |
13
+
14
+ ## Example
15
+
16
+ ```ruby
17
+ require 'tca_client'
18
+
19
+ instance = TCAClient::SubmissionBaseMetadata.new(
20
+ submitter: null,
21
+ owners: null,
22
+ group: null,
23
+ group_context: null,
24
+ original_submitted_time: null,
25
+ custom: {&quot;Hello&quot;: &quot;data&quot;}
26
+ )
27
+ ```
12
28
 
@@ -0,0 +1,40 @@
1
+ # TCAClient::SubmissionCompleteWebhookRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **owner** | **String** | the owner of the submission | [optional] |
8
+ | **title** | **String** | the title of the submission | [optional] |
9
+ | **status** | **String** | the current status of the Submission | [optional] |
10
+ | **id** | **String** | the unique ID of the submission | [optional] |
11
+ | **content_type** | **String** | the content type of the submission | [optional] |
12
+ | **page_count** | **Integer** | the number of pages in the submission | [optional] |
13
+ | **word_count** | **Integer** | the number of words in the submission | [optional] |
14
+ | **character_count** | **Integer** | the number of characters in the submission | [optional] |
15
+ | **error_code** | **String** | an error code representing the type of error encountered (if applicable) | [optional] |
16
+ | **created_time** | **Time** | RFC3339 timestamp of when this submission was initially created. This is the time at which the POST to /submissions was made. | [optional] |
17
+ | **capabilities** | **Array&lt;String&gt;** | Set of capabilities available to the current submission | [optional] |
18
+ | **metadata** | [**SubmissionCompleteWebhookRequestAllOfMetadata**](SubmissionCompleteWebhookRequestAllOfMetadata.md) | | [optional] |
19
+
20
+ ## Example
21
+
22
+ ```ruby
23
+ require 'tca_client'
24
+
25
+ instance = TCAClient::SubmissionCompleteWebhookRequest.new(
26
+ owner: null,
27
+ title: null,
28
+ status: null,
29
+ id: null,
30
+ content_type: null,
31
+ page_count: null,
32
+ word_count: null,
33
+ character_count: null,
34
+ error_code: null,
35
+ created_time: null,
36
+ capabilities: null,
37
+ metadata: null
38
+ )
39
+ ```
40
+
@@ -0,0 +1,18 @@
1
+ # TCAClient::SubmissionCompleteWebhookRequestAllOf
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **metadata** | [**SubmissionCompleteWebhookRequestAllOfMetadata**](SubmissionCompleteWebhookRequestAllOfMetadata.md) | | [optional] |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'tca_client'
13
+
14
+ instance = TCAClient::SubmissionCompleteWebhookRequestAllOf.new(
15
+ metadata: null
16
+ )
17
+ ```
18
+
@@ -0,0 +1,18 @@
1
+ # TCAClient::SubmissionCompleteWebhookRequestAllOfMetadata
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **custom** | **String** | | [optional] |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'tca_client'
13
+
14
+ instance = TCAClient::SubmissionCompleteWebhookRequestAllOfMetadata.new(
15
+ custom: null
16
+ )
17
+ ```
18
+