ultracart_api 4.1.12 → 4.1.14

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.
@@ -1,723 +1,555 @@
1
- # UltracartClient::DatawarehouseApi
2
-
3
- All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
-
5
- | Method | HTTP request | Description |
6
- | ------ | ------------ | ----------- |
7
- | [**delete_report**](DatawarehouseApi.md#delete_report) | **DELETE** /datawarehouse/reports/{report_oid} | Delete a report |
8
- | [**dry_run_report_queries**](DatawarehouseApi.md#dry_run_report_queries) | **PUT** /datawarehouse/reports/dryrun | Dry run the report queries |
9
- | [**execute_report_queries**](DatawarehouseApi.md#execute_report_queries) | **PUT** /datawarehouse/reports/execute | Execute the report queries |
10
- | [**get_report**](DatawarehouseApi.md#get_report) | **GET** /datawarehouse/reports/{report_oid} | Get a report |
11
- | [**get_report_data_set**](DatawarehouseApi.md#get_report_data_set) | **GET** /datawarehouse/reports/dataset/{dataset_uuid} | Get a report data set |
12
- | [**get_report_data_set_page**](DatawarehouseApi.md#get_report_data_set_page) | **GET** /datawarehouse/reports/dataset/{dataset_uuid}/pages/{page_number} | Get a report data set page |
13
- | [**get_report_websocket_authorization**](DatawarehouseApi.md#get_report_websocket_authorization) | **PUT** /datawarehouse/reports/auth | Get report websocket authorization |
14
- | [**get_reports**](DatawarehouseApi.md#get_reports) | **GET** /datawarehouse/reports | Get list of reports available |
15
- | [**insert_report**](DatawarehouseApi.md#insert_report) | **POST** /datawarehouse/reports | Create a report |
16
- | [**update_report**](DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report |
17
-
18
-
19
- ## delete_report
20
-
21
- > delete_report(report_oid)
22
-
23
- Delete a report
24
-
25
- Delete a report on the UltraCart account.
26
-
27
- ### Examples
28
-
29
- ```ruby
30
- require 'time'
31
- require 'ultracart_api'
32
- require 'json'
33
- require 'yaml'
34
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
35
-
36
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
37
- # As such, this might not be the best way to use this object.
38
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
39
-
40
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
41
- report_oid = 56 # Integer | The report oid to delete.
42
-
43
- begin
44
- # Delete a report
45
- api_instance.delete_report(report_oid)
46
- rescue UltracartClient::ApiError => e
47
- puts "Error when calling DatawarehouseApi->delete_report: #{e}"
48
- end
49
- ```
50
-
51
- #### Using the delete_report_with_http_info variant
52
-
53
- This returns an Array which contains the response data (`nil` in this case), status code and headers.
54
-
55
- > <Array(nil, Integer, Hash)> delete_report_with_http_info(report_oid)
56
-
57
- ```ruby
58
- begin
59
- # Delete a report
60
- data, status_code, headers = api_instance.delete_report_with_http_info(report_oid)
61
- p status_code # => 2xx
62
- p headers # => { ... }
63
- p data # => nil
64
- rescue UltracartClient::ApiError => e
65
- puts "Error when calling DatawarehouseApi->delete_report_with_http_info: #{e}"
66
- end
67
- ```
68
-
69
- ### Parameters
70
-
71
- | Name | Type | Description | Notes |
72
- | ---- | ---- | ----------- | ----- |
73
- | **report_oid** | **Integer** | The report oid to delete. | |
74
-
75
- ### Return type
76
-
77
- nil (empty response body)
78
-
79
- ### Authorization
80
-
81
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
82
-
83
- ### HTTP request headers
84
-
85
- - **Content-Type**: Not defined
86
- - **Accept**: application/json
87
-
88
-
89
- ## dry_run_report_queries
90
-
91
- > <ReportDryRunQueriesResponse> dry_run_report_queries(query_request)
92
-
93
- Dry run the report queries
94
-
95
- Dry run the report queries
96
-
97
- ### Examples
98
-
99
- ```ruby
100
- require 'time'
101
- require 'ultracart_api'
102
- require 'json'
103
- require 'yaml'
104
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
105
-
106
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
107
- # As such, this might not be the best way to use this object.
108
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
109
-
110
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
111
- query_request = UltracartClient::ReportDryRunQueriesRequest.new # ReportDryRunQueriesRequest | Dry run request
112
-
113
- begin
114
- # Dry run the report queries
115
- result = api_instance.dry_run_report_queries(query_request)
116
- p result
117
- rescue UltracartClient::ApiError => e
118
- puts "Error when calling DatawarehouseApi->dry_run_report_queries: #{e}"
119
- end
120
- ```
121
-
122
- #### Using the dry_run_report_queries_with_http_info variant
123
-
124
- This returns an Array which contains the response data, status code and headers.
125
-
126
- > <Array(<ReportDryRunQueriesResponse>, Integer, Hash)> dry_run_report_queries_with_http_info(query_request)
127
-
128
- ```ruby
129
- begin
130
- # Dry run the report queries
131
- data, status_code, headers = api_instance.dry_run_report_queries_with_http_info(query_request)
132
- p status_code # => 2xx
133
- p headers # => { ... }
134
- p data # => <ReportDryRunQueriesResponse>
135
- rescue UltracartClient::ApiError => e
136
- puts "Error when calling DatawarehouseApi->dry_run_report_queries_with_http_info: #{e}"
137
- end
138
- ```
139
-
140
- ### Parameters
141
-
142
- | Name | Type | Description | Notes |
143
- | ---- | ---- | ----------- | ----- |
144
- | **query_request** | [**ReportDryRunQueriesRequest**](ReportDryRunQueriesRequest.md) | Dry run request | |
145
-
146
- ### Return type
147
-
148
- [**ReportDryRunQueriesResponse**](ReportDryRunQueriesResponse.md)
149
-
150
- ### Authorization
151
-
152
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
153
-
154
- ### HTTP request headers
155
-
156
- - **Content-Type**: application/json
157
- - **Accept**: application/json
158
-
159
-
160
- ## execute_report_queries
161
-
162
- > execute_report_queries(query_request)
163
-
164
- Execute the report queries
165
-
166
- Execute the report queries
167
-
168
- ### Examples
169
-
170
- ```ruby
171
- require 'time'
172
- require 'ultracart_api'
173
- require 'json'
174
- require 'yaml'
175
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
176
-
177
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
178
- # As such, this might not be the best way to use this object.
179
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
180
-
181
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
182
- query_request = UltracartClient::ReportExecuteQueriesRequest.new # ReportExecuteQueriesRequest | Query request
183
-
184
- begin
185
- # Execute the report queries
186
- api_instance.execute_report_queries(query_request)
187
- rescue UltracartClient::ApiError => e
188
- puts "Error when calling DatawarehouseApi->execute_report_queries: #{e}"
189
- end
190
- ```
191
-
192
- #### Using the execute_report_queries_with_http_info variant
193
-
194
- This returns an Array which contains the response data (`nil` in this case), status code and headers.
195
-
196
- > <Array(nil, Integer, Hash)> execute_report_queries_with_http_info(query_request)
197
-
198
- ```ruby
199
- begin
200
- # Execute the report queries
201
- data, status_code, headers = api_instance.execute_report_queries_with_http_info(query_request)
202
- p status_code # => 2xx
203
- p headers # => { ... }
204
- p data # => nil
205
- rescue UltracartClient::ApiError => e
206
- puts "Error when calling DatawarehouseApi->execute_report_queries_with_http_info: #{e}"
207
- end
208
- ```
209
-
210
- ### Parameters
211
-
212
- | Name | Type | Description | Notes |
213
- | ---- | ---- | ----------- | ----- |
214
- | **query_request** | [**ReportExecuteQueriesRequest**](ReportExecuteQueriesRequest.md) | Query request | |
215
-
216
- ### Return type
217
-
218
- nil (empty response body)
219
-
220
- ### Authorization
221
-
222
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
223
-
224
- ### HTTP request headers
225
-
226
- - **Content-Type**: application/json
227
- - **Accept**: application/json
228
-
229
-
230
- ## get_report
231
-
232
- > <ReportResponse> get_report(report_oid)
233
-
234
- Get a report
235
-
236
- Retrieve a report
237
-
238
- ### Examples
239
-
240
- ```ruby
241
- require 'time'
242
- require 'ultracart_api'
243
- require 'json'
244
- require 'yaml'
245
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
246
-
247
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
248
- # As such, this might not be the best way to use this object.
249
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
250
-
251
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
252
- report_oid = 56 # Integer |
253
-
254
- begin
255
- # Get a report
256
- result = api_instance.get_report(report_oid)
257
- p result
258
- rescue UltracartClient::ApiError => e
259
- puts "Error when calling DatawarehouseApi->get_report: #{e}"
260
- end
261
- ```
262
-
263
- #### Using the get_report_with_http_info variant
264
-
265
- This returns an Array which contains the response data, status code and headers.
266
-
267
- > <Array(<ReportResponse>, Integer, Hash)> get_report_with_http_info(report_oid)
268
-
269
- ```ruby
270
- begin
271
- # Get a report
272
- data, status_code, headers = api_instance.get_report_with_http_info(report_oid)
273
- p status_code # => 2xx
274
- p headers # => { ... }
275
- p data # => <ReportResponse>
276
- rescue UltracartClient::ApiError => e
277
- puts "Error when calling DatawarehouseApi->get_report_with_http_info: #{e}"
278
- end
279
- ```
280
-
281
- ### Parameters
282
-
283
- | Name | Type | Description | Notes |
284
- | ---- | ---- | ----------- | ----- |
285
- | **report_oid** | **Integer** | | |
286
-
287
- ### Return type
288
-
289
- [**ReportResponse**](ReportResponse.md)
290
-
291
- ### Authorization
292
-
293
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
294
-
295
- ### HTTP request headers
296
-
297
- - **Content-Type**: Not defined
298
- - **Accept**: application/json
299
-
300
-
301
- ## get_report_data_set
302
-
303
- > <ReportDataSetResponse> get_report_data_set(dataset_uuid)
304
-
305
- Get a report data set
306
-
307
- Retrieve a report data set
308
-
309
- ### Examples
310
-
311
- ```ruby
312
- require 'time'
313
- require 'ultracart_api'
314
- require 'json'
315
- require 'yaml'
316
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
317
-
318
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
319
- # As such, this might not be the best way to use this object.
320
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
321
-
322
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
323
- dataset_uuid = 'dataset_uuid_example' # String |
324
-
325
- begin
326
- # Get a report data set
327
- result = api_instance.get_report_data_set(dataset_uuid)
328
- p result
329
- rescue UltracartClient::ApiError => e
330
- puts "Error when calling DatawarehouseApi->get_report_data_set: #{e}"
331
- end
332
- ```
333
-
334
- #### Using the get_report_data_set_with_http_info variant
335
-
336
- This returns an Array which contains the response data, status code and headers.
337
-
338
- > <Array(<ReportDataSetResponse>, Integer, Hash)> get_report_data_set_with_http_info(dataset_uuid)
339
-
340
- ```ruby
341
- begin
342
- # Get a report data set
343
- data, status_code, headers = api_instance.get_report_data_set_with_http_info(dataset_uuid)
344
- p status_code # => 2xx
345
- p headers # => { ... }
346
- p data # => <ReportDataSetResponse>
347
- rescue UltracartClient::ApiError => e
348
- puts "Error when calling DatawarehouseApi->get_report_data_set_with_http_info: #{e}"
349
- end
350
- ```
351
-
352
- ### Parameters
353
-
354
- | Name | Type | Description | Notes |
355
- | ---- | ---- | ----------- | ----- |
356
- | **dataset_uuid** | **String** | | |
357
-
358
- ### Return type
359
-
360
- [**ReportDataSetResponse**](ReportDataSetResponse.md)
361
-
362
- ### Authorization
363
-
364
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
365
-
366
- ### HTTP request headers
367
-
368
- - **Content-Type**: Not defined
369
- - **Accept**: application/json
370
-
371
-
372
- ## get_report_data_set_page
373
-
374
- > <ReportDataSetPageResponse> get_report_data_set_page(dataset_uuid, page_number)
375
-
376
- Get a report data set page
377
-
378
- Retrieve a report data set page
379
-
380
- ### Examples
381
-
382
- ```ruby
383
- require 'time'
384
- require 'ultracart_api'
385
- require 'json'
386
- require 'yaml'
387
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
388
-
389
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
390
- # As such, this might not be the best way to use this object.
391
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
392
-
393
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
394
- dataset_uuid = 'dataset_uuid_example' # String |
395
- page_number = 56 # Integer |
396
-
397
- begin
398
- # Get a report data set page
399
- result = api_instance.get_report_data_set_page(dataset_uuid, page_number)
400
- p result
401
- rescue UltracartClient::ApiError => e
402
- puts "Error when calling DatawarehouseApi->get_report_data_set_page: #{e}"
403
- end
404
- ```
405
-
406
- #### Using the get_report_data_set_page_with_http_info variant
407
-
408
- This returns an Array which contains the response data, status code and headers.
409
-
410
- > <Array(<ReportDataSetPageResponse>, Integer, Hash)> get_report_data_set_page_with_http_info(dataset_uuid, page_number)
411
-
412
- ```ruby
413
- begin
414
- # Get a report data set page
415
- data, status_code, headers = api_instance.get_report_data_set_page_with_http_info(dataset_uuid, page_number)
416
- p status_code # => 2xx
417
- p headers # => { ... }
418
- p data # => <ReportDataSetPageResponse>
419
- rescue UltracartClient::ApiError => e
420
- puts "Error when calling DatawarehouseApi->get_report_data_set_page_with_http_info: #{e}"
421
- end
422
- ```
423
-
424
- ### Parameters
425
-
426
- | Name | Type | Description | Notes |
427
- | ---- | ---- | ----------- | ----- |
428
- | **dataset_uuid** | **String** | | |
429
- | **page_number** | **Integer** | | |
430
-
431
- ### Return type
432
-
433
- [**ReportDataSetPageResponse**](ReportDataSetPageResponse.md)
434
-
435
- ### Authorization
436
-
437
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
438
-
439
- ### HTTP request headers
440
-
441
- - **Content-Type**: Not defined
442
- - **Accept**: application/json
443
-
444
-
445
- ## get_report_websocket_authorization
446
-
447
- > <ReportAuthResponse> get_report_websocket_authorization
448
-
449
- Get report websocket authorization
450
-
451
- Retrieve a JWT to authorize a report to make a websocket connection.
452
-
453
- ### Examples
454
-
455
- ```ruby
456
- require 'time'
457
- require 'ultracart_api'
458
- require 'json'
459
- require 'yaml'
460
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
461
-
462
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
463
- # As such, this might not be the best way to use this object.
464
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
465
-
466
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
467
-
468
- begin
469
- # Get report websocket authorization
470
- result = api_instance.get_report_websocket_authorization
471
- p result
472
- rescue UltracartClient::ApiError => e
473
- puts "Error when calling DatawarehouseApi->get_report_websocket_authorization: #{e}"
474
- end
475
- ```
476
-
477
- #### Using the get_report_websocket_authorization_with_http_info variant
478
-
479
- This returns an Array which contains the response data, status code and headers.
480
-
481
- > <Array(<ReportAuthResponse>, Integer, Hash)> get_report_websocket_authorization_with_http_info
482
-
483
- ```ruby
484
- begin
485
- # Get report websocket authorization
486
- data, status_code, headers = api_instance.get_report_websocket_authorization_with_http_info
487
- p status_code # => 2xx
488
- p headers # => { ... }
489
- p data # => <ReportAuthResponse>
490
- rescue UltracartClient::ApiError => e
491
- puts "Error when calling DatawarehouseApi->get_report_websocket_authorization_with_http_info: #{e}"
492
- end
493
- ```
494
-
495
- ### Parameters
496
-
497
- This endpoint does not need any parameter.
498
-
499
- ### Return type
500
-
501
- [**ReportAuthResponse**](ReportAuthResponse.md)
502
-
503
- ### Authorization
504
-
505
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
506
-
507
- ### HTTP request headers
508
-
509
- - **Content-Type**: Not defined
510
- - **Accept**: application/json
511
-
512
-
513
- ## get_reports
514
-
515
- > <ReportsResponse> get_reports
516
-
517
- Get list of reports available
518
-
519
- Retrieve a list of reports available
520
-
521
- ### Examples
522
-
523
- ```ruby
524
- require 'time'
525
- require 'ultracart_api'
526
- require 'json'
527
- require 'yaml'
528
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
529
-
530
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
531
- # As such, this might not be the best way to use this object.
532
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
533
-
534
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
535
-
536
- begin
537
- # Get list of reports available
538
- result = api_instance.get_reports
539
- p result
540
- rescue UltracartClient::ApiError => e
541
- puts "Error when calling DatawarehouseApi->get_reports: #{e}"
542
- end
543
- ```
544
-
545
- #### Using the get_reports_with_http_info variant
546
-
547
- This returns an Array which contains the response data, status code and headers.
548
-
549
- > <Array(<ReportsResponse>, Integer, Hash)> get_reports_with_http_info
550
-
551
- ```ruby
552
- begin
553
- # Get list of reports available
554
- data, status_code, headers = api_instance.get_reports_with_http_info
555
- p status_code # => 2xx
556
- p headers # => { ... }
557
- p data # => <ReportsResponse>
558
- rescue UltracartClient::ApiError => e
559
- puts "Error when calling DatawarehouseApi->get_reports_with_http_info: #{e}"
560
- end
561
- ```
562
-
563
- ### Parameters
564
-
565
- This endpoint does not need any parameter.
566
-
567
- ### Return type
568
-
569
- [**ReportsResponse**](ReportsResponse.md)
570
-
571
- ### Authorization
572
-
573
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
574
-
575
- ### HTTP request headers
576
-
577
- - **Content-Type**: Not defined
578
- - **Accept**: application/json
579
-
580
-
581
- ## insert_report
582
-
583
- > <ReportResponse> insert_report(report)
584
-
585
- Create a report
586
-
587
- Create a new report on the UltraCart account.
588
-
589
- ### Examples
590
-
591
- ```ruby
592
- require 'time'
593
- require 'ultracart_api'
594
- require 'json'
595
- require 'yaml'
596
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
597
-
598
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
599
- # As such, this might not be the best way to use this object.
600
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
601
-
602
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
603
- report = UltracartClient::Report.new # Report | Report to create
604
-
605
- begin
606
- # Create a report
607
- result = api_instance.insert_report(report)
608
- p result
609
- rescue UltracartClient::ApiError => e
610
- puts "Error when calling DatawarehouseApi->insert_report: #{e}"
611
- end
612
- ```
613
-
614
- #### Using the insert_report_with_http_info variant
615
-
616
- This returns an Array which contains the response data, status code and headers.
617
-
618
- > <Array(<ReportResponse>, Integer, Hash)> insert_report_with_http_info(report)
619
-
620
- ```ruby
621
- begin
622
- # Create a report
623
- data, status_code, headers = api_instance.insert_report_with_http_info(report)
624
- p status_code # => 2xx
625
- p headers # => { ... }
626
- p data # => <ReportResponse>
627
- rescue UltracartClient::ApiError => e
628
- puts "Error when calling DatawarehouseApi->insert_report_with_http_info: #{e}"
629
- end
630
- ```
631
-
632
- ### Parameters
633
-
634
- | Name | Type | Description | Notes |
635
- | ---- | ---- | ----------- | ----- |
636
- | **report** | [**Report**](Report.md) | Report to create | |
637
-
638
- ### Return type
639
-
640
- [**ReportResponse**](ReportResponse.md)
641
-
642
- ### Authorization
643
-
644
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
645
-
646
- ### HTTP request headers
647
-
648
- - **Content-Type**: application/json; charset=UTF-8
649
- - **Accept**: application/json
650
-
651
-
652
- ## update_report
653
-
654
- > <ReportResponse> update_report(report_oid, report)
655
-
656
- Update a report
657
-
658
- Update a report on the UltraCart account.
659
-
660
- ### Examples
661
-
662
- ```ruby
663
- require 'time'
664
- require 'ultracart_api'
665
- require 'json'
666
- require 'yaml'
667
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
668
-
669
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
670
- # As such, this might not be the best way to use this object.
671
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
672
-
673
- api = UltracartClient::DatawarehouseApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
674
- report_oid = 56 # Integer | The report oid to update.
675
- report = UltracartClient::Report.new # Report | Report to update
676
-
677
- begin
678
- # Update a report
679
- result = api_instance.update_report(report_oid, report)
680
- p result
681
- rescue UltracartClient::ApiError => e
682
- puts "Error when calling DatawarehouseApi->update_report: #{e}"
683
- end
684
- ```
685
-
686
- #### Using the update_report_with_http_info variant
687
-
688
- This returns an Array which contains the response data, status code and headers.
689
-
690
- > <Array(<ReportResponse>, Integer, Hash)> update_report_with_http_info(report_oid, report)
691
-
692
- ```ruby
693
- begin
694
- # Update a report
695
- data, status_code, headers = api_instance.update_report_with_http_info(report_oid, report)
696
- p status_code # => 2xx
697
- p headers # => { ... }
698
- p data # => <ReportResponse>
699
- rescue UltracartClient::ApiError => e
700
- puts "Error when calling DatawarehouseApi->update_report_with_http_info: #{e}"
701
- end
702
- ```
703
-
704
- ### Parameters
705
-
706
- | Name | Type | Description | Notes |
707
- | ---- | ---- | ----------- | ----- |
708
- | **report_oid** | **Integer** | The report oid to update. | |
709
- | **report** | [**Report**](Report.md) | Report to update | |
710
-
711
- ### Return type
712
-
713
- [**ReportResponse**](ReportResponse.md)
714
-
715
- ### Authorization
716
-
717
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
718
-
719
- ### HTTP request headers
720
-
721
- - **Content-Type**: application/json; charset=UTF-8
722
- - **Accept**: application/json
723
-
1
+ # UltracartClient::DatawarehouseApi
2
+
3
+ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**delete_report**](DatawarehouseApi.md#delete_report) | **DELETE** /datawarehouse/reports/{report_oid} | Delete a report |
8
+ | [**dry_run_report_queries**](DatawarehouseApi.md#dry_run_report_queries) | **PUT** /datawarehouse/reports/dryrun | Dry run the report queries |
9
+ | [**execute_report_queries**](DatawarehouseApi.md#execute_report_queries) | **PUT** /datawarehouse/reports/execute | Execute the report queries |
10
+ | [**get_report**](DatawarehouseApi.md#get_report) | **GET** /datawarehouse/reports/{report_oid} | Get a report |
11
+ | [**get_report_data_set**](DatawarehouseApi.md#get_report_data_set) | **GET** /datawarehouse/reports/dataset/{dataset_uuid} | Get a report data set |
12
+ | [**get_report_data_set_page**](DatawarehouseApi.md#get_report_data_set_page) | **GET** /datawarehouse/reports/dataset/{dataset_uuid}/pages/{page_number} | Get a report data set page |
13
+ | [**get_report_websocket_authorization**](DatawarehouseApi.md#get_report_websocket_authorization) | **PUT** /datawarehouse/reports/auth | Get report websocket authorization |
14
+ | [**get_reports**](DatawarehouseApi.md#get_reports) | **GET** /datawarehouse/reports | Get list of reports available |
15
+ | [**insert_report**](DatawarehouseApi.md#insert_report) | **POST** /datawarehouse/reports | Create a report |
16
+ | [**update_report**](DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report |
17
+
18
+
19
+ ## delete_report
20
+
21
+ > delete_report(report_oid)
22
+
23
+ Delete a report
24
+
25
+ Delete a report on the UltraCart account.
26
+
27
+
28
+ ### Examples
29
+
30
+ ```ruby
31
+ # Internal API. No samples are provided as merchants will never need this api method
32
+ ```
33
+
34
+
35
+ #### Using the delete_report_with_http_info variant
36
+
37
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
38
+
39
+ > <Array(nil, Integer, Hash)> delete_report_with_http_info(report_oid)
40
+
41
+ ```ruby
42
+ begin
43
+ # Delete a report
44
+ data, status_code, headers = api_instance.delete_report_with_http_info(report_oid)
45
+ p status_code # => 2xx
46
+ p headers # => { ... }
47
+ p data # => nil
48
+ rescue UltracartClient::ApiError => e
49
+ puts "Error when calling DatawarehouseApi->delete_report_with_http_info: #{e}"
50
+ end
51
+ ```
52
+
53
+ ### Parameters
54
+
55
+ | Name | Type | Description | Notes |
56
+ | ---- | ---- | ----------- | ----- |
57
+ | **report_oid** | **Integer** | The report oid to delete. | |
58
+
59
+ ### Return type
60
+
61
+ nil (empty response body)
62
+
63
+ ### Authorization
64
+
65
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
66
+
67
+ ### HTTP request headers
68
+
69
+ - **Content-Type**: Not defined
70
+ - **Accept**: application/json
71
+
72
+
73
+ ## dry_run_report_queries
74
+
75
+ > <ReportDryRunQueriesResponse> dry_run_report_queries(query_request)
76
+
77
+ Dry run the report queries
78
+
79
+ Dry run the report queries
80
+
81
+
82
+ ### Examples
83
+
84
+ ```ruby
85
+ # Internal API. No samples are provided as merchants will never need this api method
86
+ ```
87
+
88
+
89
+ #### Using the dry_run_report_queries_with_http_info variant
90
+
91
+ This returns an Array which contains the response data, status code and headers.
92
+
93
+ > <Array(<ReportDryRunQueriesResponse>, Integer, Hash)> dry_run_report_queries_with_http_info(query_request)
94
+
95
+ ```ruby
96
+ begin
97
+ # Dry run the report queries
98
+ data, status_code, headers = api_instance.dry_run_report_queries_with_http_info(query_request)
99
+ p status_code # => 2xx
100
+ p headers # => { ... }
101
+ p data # => <ReportDryRunQueriesResponse>
102
+ rescue UltracartClient::ApiError => e
103
+ puts "Error when calling DatawarehouseApi->dry_run_report_queries_with_http_info: #{e}"
104
+ end
105
+ ```
106
+
107
+ ### Parameters
108
+
109
+ | Name | Type | Description | Notes |
110
+ | ---- | ---- | ----------- | ----- |
111
+ | **query_request** | [**ReportDryRunQueriesRequest**](ReportDryRunQueriesRequest.md) | Dry run request | |
112
+
113
+ ### Return type
114
+
115
+ [**ReportDryRunQueriesResponse**](ReportDryRunQueriesResponse.md)
116
+
117
+ ### Authorization
118
+
119
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
120
+
121
+ ### HTTP request headers
122
+
123
+ - **Content-Type**: application/json
124
+ - **Accept**: application/json
125
+
126
+
127
+ ## execute_report_queries
128
+
129
+ > execute_report_queries(query_request)
130
+
131
+ Execute the report queries
132
+
133
+ Execute the report queries
134
+
135
+
136
+ ### Examples
137
+
138
+ ```ruby
139
+ # Internal API. No samples are provided as merchants will never need this api method
140
+ ```
141
+
142
+
143
+ #### Using the execute_report_queries_with_http_info variant
144
+
145
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
146
+
147
+ > <Array(nil, Integer, Hash)> execute_report_queries_with_http_info(query_request)
148
+
149
+ ```ruby
150
+ begin
151
+ # Execute the report queries
152
+ data, status_code, headers = api_instance.execute_report_queries_with_http_info(query_request)
153
+ p status_code # => 2xx
154
+ p headers # => { ... }
155
+ p data # => nil
156
+ rescue UltracartClient::ApiError => e
157
+ puts "Error when calling DatawarehouseApi->execute_report_queries_with_http_info: #{e}"
158
+ end
159
+ ```
160
+
161
+ ### Parameters
162
+
163
+ | Name | Type | Description | Notes |
164
+ | ---- | ---- | ----------- | ----- |
165
+ | **query_request** | [**ReportExecuteQueriesRequest**](ReportExecuteQueriesRequest.md) | Query request | |
166
+
167
+ ### Return type
168
+
169
+ nil (empty response body)
170
+
171
+ ### Authorization
172
+
173
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
174
+
175
+ ### HTTP request headers
176
+
177
+ - **Content-Type**: application/json
178
+ - **Accept**: application/json
179
+
180
+
181
+ ## get_report
182
+
183
+ > <ReportResponse> get_report(report_oid)
184
+
185
+ Get a report
186
+
187
+ Retrieve a report
188
+
189
+
190
+ ### Examples
191
+
192
+ ```ruby
193
+ # Internal API. No samples are provided as merchants will never need this api method
194
+ ```
195
+
196
+
197
+ #### Using the get_report_with_http_info variant
198
+
199
+ This returns an Array which contains the response data, status code and headers.
200
+
201
+ > <Array(<ReportResponse>, Integer, Hash)> get_report_with_http_info(report_oid)
202
+
203
+ ```ruby
204
+ begin
205
+ # Get a report
206
+ data, status_code, headers = api_instance.get_report_with_http_info(report_oid)
207
+ p status_code # => 2xx
208
+ p headers # => { ... }
209
+ p data # => <ReportResponse>
210
+ rescue UltracartClient::ApiError => e
211
+ puts "Error when calling DatawarehouseApi->get_report_with_http_info: #{e}"
212
+ end
213
+ ```
214
+
215
+ ### Parameters
216
+
217
+ | Name | Type | Description | Notes |
218
+ | ---- | ---- | ----------- | ----- |
219
+ | **report_oid** | **Integer** | | |
220
+
221
+ ### Return type
222
+
223
+ [**ReportResponse**](ReportResponse.md)
224
+
225
+ ### Authorization
226
+
227
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
228
+
229
+ ### HTTP request headers
230
+
231
+ - **Content-Type**: Not defined
232
+ - **Accept**: application/json
233
+
234
+
235
+ ## get_report_data_set
236
+
237
+ > <ReportDataSetResponse> get_report_data_set(dataset_uuid)
238
+
239
+ Get a report data set
240
+
241
+ Retrieve a report data set
242
+
243
+
244
+ ### Examples
245
+
246
+ ```ruby
247
+ # Internal API. No samples are provided as merchants will never need this api method
248
+ ```
249
+
250
+
251
+ #### Using the get_report_data_set_with_http_info variant
252
+
253
+ This returns an Array which contains the response data, status code and headers.
254
+
255
+ > <Array(<ReportDataSetResponse>, Integer, Hash)> get_report_data_set_with_http_info(dataset_uuid)
256
+
257
+ ```ruby
258
+ begin
259
+ # Get a report data set
260
+ data, status_code, headers = api_instance.get_report_data_set_with_http_info(dataset_uuid)
261
+ p status_code # => 2xx
262
+ p headers # => { ... }
263
+ p data # => <ReportDataSetResponse>
264
+ rescue UltracartClient::ApiError => e
265
+ puts "Error when calling DatawarehouseApi->get_report_data_set_with_http_info: #{e}"
266
+ end
267
+ ```
268
+
269
+ ### Parameters
270
+
271
+ | Name | Type | Description | Notes |
272
+ | ---- | ---- | ----------- | ----- |
273
+ | **dataset_uuid** | **String** | | |
274
+
275
+ ### Return type
276
+
277
+ [**ReportDataSetResponse**](ReportDataSetResponse.md)
278
+
279
+ ### Authorization
280
+
281
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
282
+
283
+ ### HTTP request headers
284
+
285
+ - **Content-Type**: Not defined
286
+ - **Accept**: application/json
287
+
288
+
289
+ ## get_report_data_set_page
290
+
291
+ > <ReportDataSetPageResponse> get_report_data_set_page(dataset_uuid, page_number)
292
+
293
+ Get a report data set page
294
+
295
+ Retrieve a report data set page
296
+
297
+
298
+ ### Examples
299
+
300
+ ```ruby
301
+ # Internal API. No samples are provided as merchants will never need this api method
302
+ ```
303
+
304
+
305
+ #### Using the get_report_data_set_page_with_http_info variant
306
+
307
+ This returns an Array which contains the response data, status code and headers.
308
+
309
+ > <Array(<ReportDataSetPageResponse>, Integer, Hash)> get_report_data_set_page_with_http_info(dataset_uuid, page_number)
310
+
311
+ ```ruby
312
+ begin
313
+ # Get a report data set page
314
+ data, status_code, headers = api_instance.get_report_data_set_page_with_http_info(dataset_uuid, page_number)
315
+ p status_code # => 2xx
316
+ p headers # => { ... }
317
+ p data # => <ReportDataSetPageResponse>
318
+ rescue UltracartClient::ApiError => e
319
+ puts "Error when calling DatawarehouseApi->get_report_data_set_page_with_http_info: #{e}"
320
+ end
321
+ ```
322
+
323
+ ### Parameters
324
+
325
+ | Name | Type | Description | Notes |
326
+ | ---- | ---- | ----------- | ----- |
327
+ | **dataset_uuid** | **String** | | |
328
+ | **page_number** | **Integer** | | |
329
+
330
+ ### Return type
331
+
332
+ [**ReportDataSetPageResponse**](ReportDataSetPageResponse.md)
333
+
334
+ ### Authorization
335
+
336
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
337
+
338
+ ### HTTP request headers
339
+
340
+ - **Content-Type**: Not defined
341
+ - **Accept**: application/json
342
+
343
+
344
+ ## get_report_websocket_authorization
345
+
346
+ > <ReportAuthResponse> get_report_websocket_authorization
347
+
348
+ Get report websocket authorization
349
+
350
+ Retrieve a JWT to authorize a report to make a websocket connection.
351
+
352
+
353
+ ### Examples
354
+
355
+ ```ruby
356
+ # Internal API. No samples are provided as merchants will never need this api method
357
+ ```
358
+
359
+
360
+ #### Using the get_report_websocket_authorization_with_http_info variant
361
+
362
+ This returns an Array which contains the response data, status code and headers.
363
+
364
+ > <Array(<ReportAuthResponse>, Integer, Hash)> get_report_websocket_authorization_with_http_info
365
+
366
+ ```ruby
367
+ begin
368
+ # Get report websocket authorization
369
+ data, status_code, headers = api_instance.get_report_websocket_authorization_with_http_info
370
+ p status_code # => 2xx
371
+ p headers # => { ... }
372
+ p data # => <ReportAuthResponse>
373
+ rescue UltracartClient::ApiError => e
374
+ puts "Error when calling DatawarehouseApi->get_report_websocket_authorization_with_http_info: #{e}"
375
+ end
376
+ ```
377
+
378
+ ### Parameters
379
+
380
+ This endpoint does not need any parameter.
381
+
382
+ ### Return type
383
+
384
+ [**ReportAuthResponse**](ReportAuthResponse.md)
385
+
386
+ ### Authorization
387
+
388
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
389
+
390
+ ### HTTP request headers
391
+
392
+ - **Content-Type**: Not defined
393
+ - **Accept**: application/json
394
+
395
+
396
+ ## get_reports
397
+
398
+ > <ReportsResponse> get_reports
399
+
400
+ Get list of reports available
401
+
402
+ Retrieve a list of reports available
403
+
404
+
405
+ ### Examples
406
+
407
+ ```ruby
408
+ # Internal API. No samples are provided as merchants will never need this api method
409
+ ```
410
+
411
+
412
+ #### Using the get_reports_with_http_info variant
413
+
414
+ This returns an Array which contains the response data, status code and headers.
415
+
416
+ > <Array(<ReportsResponse>, Integer, Hash)> get_reports_with_http_info
417
+
418
+ ```ruby
419
+ begin
420
+ # Get list of reports available
421
+ data, status_code, headers = api_instance.get_reports_with_http_info
422
+ p status_code # => 2xx
423
+ p headers # => { ... }
424
+ p data # => <ReportsResponse>
425
+ rescue UltracartClient::ApiError => e
426
+ puts "Error when calling DatawarehouseApi->get_reports_with_http_info: #{e}"
427
+ end
428
+ ```
429
+
430
+ ### Parameters
431
+
432
+ This endpoint does not need any parameter.
433
+
434
+ ### Return type
435
+
436
+ [**ReportsResponse**](ReportsResponse.md)
437
+
438
+ ### Authorization
439
+
440
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
441
+
442
+ ### HTTP request headers
443
+
444
+ - **Content-Type**: Not defined
445
+ - **Accept**: application/json
446
+
447
+
448
+ ## insert_report
449
+
450
+ > <ReportResponse> insert_report(report)
451
+
452
+ Create a report
453
+
454
+ Create a new report on the UltraCart account.
455
+
456
+
457
+ ### Examples
458
+
459
+ ```ruby
460
+ # Internal API. No samples are provided as merchants will never need this api method
461
+ ```
462
+
463
+
464
+ #### Using the insert_report_with_http_info variant
465
+
466
+ This returns an Array which contains the response data, status code and headers.
467
+
468
+ > <Array(<ReportResponse>, Integer, Hash)> insert_report_with_http_info(report)
469
+
470
+ ```ruby
471
+ begin
472
+ # Create a report
473
+ data, status_code, headers = api_instance.insert_report_with_http_info(report)
474
+ p status_code # => 2xx
475
+ p headers # => { ... }
476
+ p data # => <ReportResponse>
477
+ rescue UltracartClient::ApiError => e
478
+ puts "Error when calling DatawarehouseApi->insert_report_with_http_info: #{e}"
479
+ end
480
+ ```
481
+
482
+ ### Parameters
483
+
484
+ | Name | Type | Description | Notes |
485
+ | ---- | ---- | ----------- | ----- |
486
+ | **report** | [**Report**](Report.md) | Report to create | |
487
+
488
+ ### Return type
489
+
490
+ [**ReportResponse**](ReportResponse.md)
491
+
492
+ ### Authorization
493
+
494
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
495
+
496
+ ### HTTP request headers
497
+
498
+ - **Content-Type**: application/json; charset=UTF-8
499
+ - **Accept**: application/json
500
+
501
+
502
+ ## update_report
503
+
504
+ > <ReportResponse> update_report(report_oid, report)
505
+
506
+ Update a report
507
+
508
+ Update a report on the UltraCart account.
509
+
510
+
511
+ ### Examples
512
+
513
+ ```ruby
514
+ # Internal API. No samples are provided as merchants will never need this api method
515
+ ```
516
+
517
+
518
+ #### Using the update_report_with_http_info variant
519
+
520
+ This returns an Array which contains the response data, status code and headers.
521
+
522
+ > <Array(<ReportResponse>, Integer, Hash)> update_report_with_http_info(report_oid, report)
523
+
524
+ ```ruby
525
+ begin
526
+ # Update a report
527
+ data, status_code, headers = api_instance.update_report_with_http_info(report_oid, report)
528
+ p status_code # => 2xx
529
+ p headers # => { ... }
530
+ p data # => <ReportResponse>
531
+ rescue UltracartClient::ApiError => e
532
+ puts "Error when calling DatawarehouseApi->update_report_with_http_info: #{e}"
533
+ end
534
+ ```
535
+
536
+ ### Parameters
537
+
538
+ | Name | Type | Description | Notes |
539
+ | ---- | ---- | ----------- | ----- |
540
+ | **report_oid** | **Integer** | The report oid to update. | |
541
+ | **report** | [**Report**](Report.md) | Report to update | |
542
+
543
+ ### Return type
544
+
545
+ [**ReportResponse**](ReportResponse.md)
546
+
547
+ ### Authorization
548
+
549
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
550
+
551
+ ### HTTP request headers
552
+
553
+ - **Content-Type**: application/json; charset=UTF-8
554
+ - **Accept**: application/json
555
+