ultracart_api 4.1.208 → 4.1.209
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.
- checksums.yaml +4 -4
- data/README.md +23 -2
- data/docs/SfvbApi.md +613 -0
- data/docs/SfvbArchiveRequest.md +18 -0
- data/docs/SfvbCampaign.md +16 -0
- data/docs/SfvbCampaignMembership.md +24 -0
- data/docs/SfvbCampaignWriteRequest.md +32 -0
- data/docs/SfvbCommsEmail.md +6 -0
- data/docs/SfvbCommsList.md +24 -0
- data/docs/SfvbCommsListsResponse.md +18 -0
- data/docs/SfvbCommsSegment.md +26 -0
- data/docs/SfvbCommsSegmentsResponse.md +18 -0
- data/docs/SfvbFlow.md +22 -0
- data/docs/SfvbFlowStatusRequest.md +18 -0
- data/docs/SfvbFlowWriteRequest.md +38 -0
- data/lib/ultracart_api/api/sfvb_api.rb +907 -49
- data/lib/ultracart_api/models/sfvb_archive_request.rb +220 -0
- data/lib/ultracart_api/models/sfvb_campaign.rb +85 -1
- data/lib/ultracart_api/models/sfvb_campaign_membership.rb +250 -0
- data/lib/ultracart_api/models/sfvb_campaign_write_request.rb +292 -0
- data/lib/ultracart_api/models/sfvb_comms_email.rb +31 -1
- data/lib/ultracart_api/models/sfvb_comms_list.rb +250 -0
- data/lib/ultracart_api/models/sfvb_comms_lists_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_comms_segment.rb +260 -0
- data/lib/ultracart_api/models/sfvb_comms_segments_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_flow.rb +113 -1
- data/lib/ultracart_api/models/sfvb_flow_status_request.rb +254 -0
- data/lib/ultracart_api/models/sfvb_flow_write_request.rb +354 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +9 -0
- metadata +20 -2
data/docs/SfvbApi.md
CHANGED
|
@@ -6,11 +6,17 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
6
6
|
| ------ | ------------ | ----------- |
|
|
7
7
|
| [**add_sfvb_page_blog_posts**](SfvbApi.md#add_sfvb_page_blog_posts) | **POST** /sfvb/storefronts/{storefront_oid}/pages/blog_posts/add | Assign blog posts to a page |
|
|
8
8
|
| [**add_sfvb_page_items**](SfvbApi.md#add_sfvb_page_items) | **POST** /sfvb/storefronts/{storefront_oid}/pages/items/add | Assign items to a page |
|
|
9
|
+
| [**archive_sfvb_campaign**](SfvbApi.md#archive_sfvb_campaign) | **PUT** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid}/archive | Archive or unarchive a campaign |
|
|
10
|
+
| [**archive_sfvb_flow**](SfvbApi.md#archive_sfvb_flow) | **PUT** /sfvb/storefronts/{storefront_oid}/flows/{flow_uuid}/archive | Archive or unarchive a flow |
|
|
9
11
|
| [**archive_sfvb_upsell_path**](SfvbApi.md#archive_sfvb_upsell_path) | **POST** /sfvb/storefronts/{storefront_oid}/upsell_paths/{upsell_path_oid}/archive | Archive an upsell path |
|
|
10
12
|
| [**attach_sfvb_blog_post_image**](SfvbApi.md#attach_sfvb_blog_post_image) | **POST** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid}/images/attach | Attach an image to a blog post |
|
|
11
13
|
| [**check_sfvb_redirect**](SfvbApi.md#check_sfvb_redirect) | **POST** /sfvb/storefronts/{storefront_oid}/redirects/check | Check a redirect rule without creating it |
|
|
12
14
|
| [**clear_sfvb_library_screenshot**](SfvbApi.md#clear_sfvb_library_screenshot) | **DELETE** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/screenshot | Remove a library entry's screenshot |
|
|
15
|
+
| [**clone_sfvb_campaign**](SfvbApi.md#clone_sfvb_campaign) | **POST** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid}/clone | Copy a campaign on the same storefront |
|
|
16
|
+
| [**clone_sfvb_flow**](SfvbApi.md#clone_sfvb_flow) | **POST** /sfvb/storefronts/{storefront_oid}/flows/{flow_uuid}/clone | Copy a flow on the same storefront |
|
|
13
17
|
| [**compile_sfvb_cjson**](SfvbApi.md#compile_sfvb_cjson) | **POST** /sfvb/cjson/compile | Compile CJSON to Velocity |
|
|
18
|
+
| [**create_sfvb_campaign**](SfvbApi.md#create_sfvb_campaign) | **POST** /sfvb/storefronts/{storefront_oid}/campaigns | Create a draft campaign |
|
|
19
|
+
| [**create_sfvb_flow**](SfvbApi.md#create_sfvb_flow) | **POST** /sfvb/storefronts/{storefront_oid}/flows | Create a draft flow |
|
|
14
20
|
| [**create_sfvb_library_entry**](SfvbApi.md#create_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library | Save a fragment to the library |
|
|
15
21
|
| [**create_sfvb_preview_access**](SfvbApi.md#create_sfvb_preview_access) | **POST** /sfvb/storefronts/{storefront_oid}/preview_access | One time link that opens a preview in a browser with no UltraCart login |
|
|
16
22
|
| [**create_sfvb_preview_session**](SfvbApi.md#create_sfvb_preview_session) | **POST** /sfvb/storefronts/{storefront_oid}/preview_sessions | Create a preview session |
|
|
@@ -119,6 +125,8 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
119
125
|
| [**install_sfvb_library_entry**](SfvbApi.md#install_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/install | Install a library entry into a storefront |
|
|
120
126
|
| [**list_sfvb_blog_posts**](SfvbApi.md#list_sfvb_blog_posts) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts | List the storefront's blog posts |
|
|
121
127
|
| [**list_sfvb_campaigns**](SfvbApi.md#list_sfvb_campaigns) | **GET** /sfvb/storefronts/{storefront_oid}/campaigns | List the storefront's campaigns |
|
|
128
|
+
| [**list_sfvb_comms_lists**](SfvbApi.md#list_sfvb_comms_lists) | **GET** /sfvb/storefronts/{storefront_oid}/lists | List the storefront's email lists |
|
|
129
|
+
| [**list_sfvb_comms_segments**](SfvbApi.md#list_sfvb_comms_segments) | **GET** /sfvb/storefronts/{storefront_oid}/segments | List the storefront's segments |
|
|
122
130
|
| [**list_sfvb_container_versions**](SfvbApi.md#list_sfvb_container_versions) | **GET** /sfvb/storefronts/{storefront_oid}/container_versions | Version history for a container stored outside the file system |
|
|
123
131
|
| [**list_sfvb_elements**](SfvbApi.md#list_sfvb_elements) | **GET** /sfvb/elements | List every SFVB element type |
|
|
124
132
|
| [**list_sfvb_experiments**](SfvbApi.md#list_sfvb_experiments) | **GET** /sfvb/storefronts/{storefront_oid}/experiments | List the storefront's experiments |
|
|
@@ -183,9 +191,12 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
183
191
|
| [**unpublish_sfvb_library_entry**](SfvbApi.md#unpublish_sfvb_library_entry) | **POST** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/unpublish | Narrow who can see a library entry |
|
|
184
192
|
| [**unshare_sfvb_library_entry**](SfvbApi.md#unshare_sfvb_library_entry) | **DELETE** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/shares/{merchant_id} | Stop sharing a library entry with an account |
|
|
185
193
|
| [**update_sfvb_blog_post**](SfvbApi.md#update_sfvb_blog_post) | **PUT** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Change a blog post |
|
|
194
|
+
| [**update_sfvb_campaign**](SfvbApi.md#update_sfvb_campaign) | **PUT** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid} | Change a campaign |
|
|
186
195
|
| [**update_sfvb_comms_sending_domain**](SfvbApi.md#update_sfvb_comms_sending_domain) | **PUT** /sfvb/comms/sending_domains/{domain} | Update a sending domain |
|
|
187
196
|
| [**update_sfvb_comms_twilio_account**](SfvbApi.md#update_sfvb_comms_twilio_account) | **PUT** /sfvb/comms/twilio_account | Update the Twilio account |
|
|
188
197
|
| [**update_sfvb_email**](SfvbApi.md#update_sfvb_email) | **PUT** /sfvb/storefronts/{storefront_oid}/emails/{email_uuid} | Change a flow or campaign email's subject or preview text |
|
|
198
|
+
| [**update_sfvb_flow**](SfvbApi.md#update_sfvb_flow) | **PUT** /sfvb/storefronts/{storefront_oid}/flows/{flow_uuid} | Change a flow |
|
|
199
|
+
| [**update_sfvb_flow_status**](SfvbApi.md#update_sfvb_flow_status) | **PUT** /sfvb/storefronts/{storefront_oid}/flows/{flow_uuid}/status | Turn a flow on or off |
|
|
189
200
|
| [**update_sfvb_item_attribute_batch**](SfvbApi.md#update_sfvb_item_attribute_batch) | **POST** /sfvb/storefronts/{storefront_oid}/items/attributes/batch | Change attributes across many items in one call |
|
|
190
201
|
| [**update_sfvb_library_entry**](SfvbApi.md#update_sfvb_library_entry) | **PUT** /sfvb/storefronts/{storefront_oid}/library/{library_oid} | Update a library entry's draft |
|
|
191
202
|
| [**update_sfvb_redirect**](SfvbApi.md#update_sfvb_redirect) | **PUT** /sfvb/storefronts/{storefront_oid}/redirects/{redirect_id} | Change a redirect rule |
|
|
@@ -306,6 +317,118 @@ end
|
|
|
306
317
|
- **Accept**: application/json
|
|
307
318
|
|
|
308
319
|
|
|
320
|
+
## archive_sfvb_campaign
|
|
321
|
+
|
|
322
|
+
> <SfvbCampaign> archive_sfvb_campaign(storefront_oid, campaign_uuid, if_match, archive_request)
|
|
323
|
+
|
|
324
|
+
Archive or unarchive a campaign
|
|
325
|
+
|
|
326
|
+
Archiving alone never stops a send, so archiving a scheduled campaign also sets it back to draft, and notes says so. A campaign whose send is under way is refused with sfvb.campaign_sending. Send the hash_sha256 you read as If-Match. A scheduled, sending or sent campaign needs sfvb_publish.
|
|
327
|
+
|
|
328
|
+
|
|
329
|
+
### Examples
|
|
330
|
+
|
|
331
|
+
|
|
332
|
+
(No example for this operation).
|
|
333
|
+
|
|
334
|
+
|
|
335
|
+
#### Using the archive_sfvb_campaign_with_http_info variant
|
|
336
|
+
|
|
337
|
+
This returns an Array which contains the response data, status code and headers.
|
|
338
|
+
|
|
339
|
+
> <Array(<SfvbCampaign>, Integer, Hash)> archive_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid, if_match, archive_request)
|
|
340
|
+
|
|
341
|
+
```ruby
|
|
342
|
+
begin
|
|
343
|
+
# Archive or unarchive a campaign
|
|
344
|
+
data, status_code, headers = api_instance.archive_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid, if_match, archive_request)
|
|
345
|
+
p status_code # => 2xx
|
|
346
|
+
p headers # => { ... }
|
|
347
|
+
p data # => <SfvbCampaign>
|
|
348
|
+
rescue UltracartClient::ApiError => e
|
|
349
|
+
puts "Error when calling SfvbApi->archive_sfvb_campaign_with_http_info: #{e}"
|
|
350
|
+
end
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
### Parameters
|
|
354
|
+
|
|
355
|
+
| Name | Type | Description | Notes |
|
|
356
|
+
| ---- | ---- | ----------- | ----- |
|
|
357
|
+
| **storefront_oid** | **Integer** | | |
|
|
358
|
+
| **campaign_uuid** | **String** | | |
|
|
359
|
+
| **if_match** | **String** | hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
360
|
+
| **archive_request** | [**SfvbArchiveRequest**](SfvbArchiveRequest.md) | Whether to archive | |
|
|
361
|
+
|
|
362
|
+
### Return type
|
|
363
|
+
|
|
364
|
+
[**SfvbCampaign**](SfvbCampaign.md)
|
|
365
|
+
|
|
366
|
+
### Authorization
|
|
367
|
+
|
|
368
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
369
|
+
|
|
370
|
+
### HTTP request headers
|
|
371
|
+
|
|
372
|
+
- **Content-Type**: application/json
|
|
373
|
+
- **Accept**: application/json
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
## archive_sfvb_flow
|
|
377
|
+
|
|
378
|
+
> <SfvbFlow> archive_sfvb_flow(storefront_oid, flow_uuid, if_match, archive_request)
|
|
379
|
+
|
|
380
|
+
Archive or unarchive a flow
|
|
381
|
+
|
|
382
|
+
A flow that is still enrolling customers is refused, because archiving would only hide it. Set its status to inactive first. Send the hash_sha256 you read as If-Match.
|
|
383
|
+
|
|
384
|
+
|
|
385
|
+
### Examples
|
|
386
|
+
|
|
387
|
+
|
|
388
|
+
(No example for this operation).
|
|
389
|
+
|
|
390
|
+
|
|
391
|
+
#### Using the archive_sfvb_flow_with_http_info variant
|
|
392
|
+
|
|
393
|
+
This returns an Array which contains the response data, status code and headers.
|
|
394
|
+
|
|
395
|
+
> <Array(<SfvbFlow>, Integer, Hash)> archive_sfvb_flow_with_http_info(storefront_oid, flow_uuid, if_match, archive_request)
|
|
396
|
+
|
|
397
|
+
```ruby
|
|
398
|
+
begin
|
|
399
|
+
# Archive or unarchive a flow
|
|
400
|
+
data, status_code, headers = api_instance.archive_sfvb_flow_with_http_info(storefront_oid, flow_uuid, if_match, archive_request)
|
|
401
|
+
p status_code # => 2xx
|
|
402
|
+
p headers # => { ... }
|
|
403
|
+
p data # => <SfvbFlow>
|
|
404
|
+
rescue UltracartClient::ApiError => e
|
|
405
|
+
puts "Error when calling SfvbApi->archive_sfvb_flow_with_http_info: #{e}"
|
|
406
|
+
end
|
|
407
|
+
```
|
|
408
|
+
|
|
409
|
+
### Parameters
|
|
410
|
+
|
|
411
|
+
| Name | Type | Description | Notes |
|
|
412
|
+
| ---- | ---- | ----------- | ----- |
|
|
413
|
+
| **storefront_oid** | **Integer** | | |
|
|
414
|
+
| **flow_uuid** | **String** | | |
|
|
415
|
+
| **if_match** | **String** | hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
416
|
+
| **archive_request** | [**SfvbArchiveRequest**](SfvbArchiveRequest.md) | Whether to archive | |
|
|
417
|
+
|
|
418
|
+
### Return type
|
|
419
|
+
|
|
420
|
+
[**SfvbFlow**](SfvbFlow.md)
|
|
421
|
+
|
|
422
|
+
### Authorization
|
|
423
|
+
|
|
424
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
425
|
+
|
|
426
|
+
### HTTP request headers
|
|
427
|
+
|
|
428
|
+
- **Content-Type**: application/json
|
|
429
|
+
- **Accept**: application/json
|
|
430
|
+
|
|
431
|
+
|
|
309
432
|
## archive_sfvb_upsell_path
|
|
310
433
|
|
|
311
434
|
> <SfvbUpsellPath> archive_sfvb_upsell_path(storefront_oid, upsell_path_oid)
|
|
@@ -524,6 +647,114 @@ end
|
|
|
524
647
|
- **Accept**: application/json
|
|
525
648
|
|
|
526
649
|
|
|
650
|
+
## clone_sfvb_campaign
|
|
651
|
+
|
|
652
|
+
> <SfvbCampaign> clone_sfvb_campaign(storefront_oid, campaign_uuid)
|
|
653
|
+
|
|
654
|
+
Copy a campaign on the same storefront
|
|
655
|
+
|
|
656
|
+
A draft copy with copies of its emails and postcards, named Copy of and the original name, never archived and never scheduled. Steps keep their settings, including a paused rate limiter or an experiment winner, and notes names each one.
|
|
657
|
+
|
|
658
|
+
|
|
659
|
+
### Examples
|
|
660
|
+
|
|
661
|
+
|
|
662
|
+
(No example for this operation).
|
|
663
|
+
|
|
664
|
+
|
|
665
|
+
#### Using the clone_sfvb_campaign_with_http_info variant
|
|
666
|
+
|
|
667
|
+
This returns an Array which contains the response data, status code and headers.
|
|
668
|
+
|
|
669
|
+
> <Array(<SfvbCampaign>, Integer, Hash)> clone_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid)
|
|
670
|
+
|
|
671
|
+
```ruby
|
|
672
|
+
begin
|
|
673
|
+
# Copy a campaign on the same storefront
|
|
674
|
+
data, status_code, headers = api_instance.clone_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid)
|
|
675
|
+
p status_code # => 2xx
|
|
676
|
+
p headers # => { ... }
|
|
677
|
+
p data # => <SfvbCampaign>
|
|
678
|
+
rescue UltracartClient::ApiError => e
|
|
679
|
+
puts "Error when calling SfvbApi->clone_sfvb_campaign_with_http_info: #{e}"
|
|
680
|
+
end
|
|
681
|
+
```
|
|
682
|
+
|
|
683
|
+
### Parameters
|
|
684
|
+
|
|
685
|
+
| Name | Type | Description | Notes |
|
|
686
|
+
| ---- | ---- | ----------- | ----- |
|
|
687
|
+
| **storefront_oid** | **Integer** | | |
|
|
688
|
+
| **campaign_uuid** | **String** | | |
|
|
689
|
+
|
|
690
|
+
### Return type
|
|
691
|
+
|
|
692
|
+
[**SfvbCampaign**](SfvbCampaign.md)
|
|
693
|
+
|
|
694
|
+
### Authorization
|
|
695
|
+
|
|
696
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
697
|
+
|
|
698
|
+
### HTTP request headers
|
|
699
|
+
|
|
700
|
+
- **Content-Type**: Not defined
|
|
701
|
+
- **Accept**: application/json
|
|
702
|
+
|
|
703
|
+
|
|
704
|
+
## clone_sfvb_flow
|
|
705
|
+
|
|
706
|
+
> <SfvbFlow> clone_sfvb_flow(storefront_oid, flow_uuid)
|
|
707
|
+
|
|
708
|
+
Copy a flow on the same storefront
|
|
709
|
+
|
|
710
|
+
A draft copy with copies of its emails and postcards, named Copy of and the original name, never archived. It enrolls nobody until it is turned on. Steps keep their settings, including a paused rate limiter or an experiment winner, and notes names each one.
|
|
711
|
+
|
|
712
|
+
|
|
713
|
+
### Examples
|
|
714
|
+
|
|
715
|
+
|
|
716
|
+
(No example for this operation).
|
|
717
|
+
|
|
718
|
+
|
|
719
|
+
#### Using the clone_sfvb_flow_with_http_info variant
|
|
720
|
+
|
|
721
|
+
This returns an Array which contains the response data, status code and headers.
|
|
722
|
+
|
|
723
|
+
> <Array(<SfvbFlow>, Integer, Hash)> clone_sfvb_flow_with_http_info(storefront_oid, flow_uuid)
|
|
724
|
+
|
|
725
|
+
```ruby
|
|
726
|
+
begin
|
|
727
|
+
# Copy a flow on the same storefront
|
|
728
|
+
data, status_code, headers = api_instance.clone_sfvb_flow_with_http_info(storefront_oid, flow_uuid)
|
|
729
|
+
p status_code # => 2xx
|
|
730
|
+
p headers # => { ... }
|
|
731
|
+
p data # => <SfvbFlow>
|
|
732
|
+
rescue UltracartClient::ApiError => e
|
|
733
|
+
puts "Error when calling SfvbApi->clone_sfvb_flow_with_http_info: #{e}"
|
|
734
|
+
end
|
|
735
|
+
```
|
|
736
|
+
|
|
737
|
+
### Parameters
|
|
738
|
+
|
|
739
|
+
| Name | Type | Description | Notes |
|
|
740
|
+
| ---- | ---- | ----------- | ----- |
|
|
741
|
+
| **storefront_oid** | **Integer** | | |
|
|
742
|
+
| **flow_uuid** | **String** | | |
|
|
743
|
+
|
|
744
|
+
### Return type
|
|
745
|
+
|
|
746
|
+
[**SfvbFlow**](SfvbFlow.md)
|
|
747
|
+
|
|
748
|
+
### Authorization
|
|
749
|
+
|
|
750
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
751
|
+
|
|
752
|
+
### HTTP request headers
|
|
753
|
+
|
|
754
|
+
- **Content-Type**: Not defined
|
|
755
|
+
- **Accept**: application/json
|
|
756
|
+
|
|
757
|
+
|
|
527
758
|
## compile_sfvb_cjson
|
|
528
759
|
|
|
529
760
|
> <SfvbCompileResponse> compile_sfvb_cjson(compile_request)
|
|
@@ -577,6 +808,114 @@ end
|
|
|
577
808
|
- **Accept**: application/json
|
|
578
809
|
|
|
579
810
|
|
|
811
|
+
## create_sfvb_campaign
|
|
812
|
+
|
|
813
|
+
> <SfvbCampaign> create_sfvb_campaign(storefront_oid, campaign_write_request)
|
|
814
|
+
|
|
815
|
+
Create a draft campaign
|
|
816
|
+
|
|
817
|
+
A new draft campaign with an empty communication sequence. name is required. The sender defaults to the storefront's marketing sending settings. Nothing here starts a campaign.
|
|
818
|
+
|
|
819
|
+
|
|
820
|
+
### Examples
|
|
821
|
+
|
|
822
|
+
|
|
823
|
+
(No example for this operation).
|
|
824
|
+
|
|
825
|
+
|
|
826
|
+
#### Using the create_sfvb_campaign_with_http_info variant
|
|
827
|
+
|
|
828
|
+
This returns an Array which contains the response data, status code and headers.
|
|
829
|
+
|
|
830
|
+
> <Array(<SfvbCampaign>, Integer, Hash)> create_sfvb_campaign_with_http_info(storefront_oid, campaign_write_request)
|
|
831
|
+
|
|
832
|
+
```ruby
|
|
833
|
+
begin
|
|
834
|
+
# Create a draft campaign
|
|
835
|
+
data, status_code, headers = api_instance.create_sfvb_campaign_with_http_info(storefront_oid, campaign_write_request)
|
|
836
|
+
p status_code # => 2xx
|
|
837
|
+
p headers # => { ... }
|
|
838
|
+
p data # => <SfvbCampaign>
|
|
839
|
+
rescue UltracartClient::ApiError => e
|
|
840
|
+
puts "Error when calling SfvbApi->create_sfvb_campaign_with_http_info: #{e}"
|
|
841
|
+
end
|
|
842
|
+
```
|
|
843
|
+
|
|
844
|
+
### Parameters
|
|
845
|
+
|
|
846
|
+
| Name | Type | Description | Notes |
|
|
847
|
+
| ---- | ---- | ----------- | ----- |
|
|
848
|
+
| **storefront_oid** | **Integer** | | |
|
|
849
|
+
| **campaign_write_request** | [**SfvbCampaignWriteRequest**](SfvbCampaignWriteRequest.md) | The campaign to create | |
|
|
850
|
+
|
|
851
|
+
### Return type
|
|
852
|
+
|
|
853
|
+
[**SfvbCampaign**](SfvbCampaign.md)
|
|
854
|
+
|
|
855
|
+
### Authorization
|
|
856
|
+
|
|
857
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
858
|
+
|
|
859
|
+
### HTTP request headers
|
|
860
|
+
|
|
861
|
+
- **Content-Type**: application/json
|
|
862
|
+
- **Accept**: application/json
|
|
863
|
+
|
|
864
|
+
|
|
865
|
+
## create_sfvb_flow
|
|
866
|
+
|
|
867
|
+
> <SfvbFlow> create_sfvb_flow(storefront_oid, flow_write_request)
|
|
868
|
+
|
|
869
|
+
Create a draft flow
|
|
870
|
+
|
|
871
|
+
A new draft flow with an empty communication sequence. name and trigger_type are required. A list or segment trigger needs trigger_parameter, the uuid of a list or segment on this storefront. The sender defaults to the storefront's marketing sending settings. A draft flow enrolls nobody until it is turned on.
|
|
872
|
+
|
|
873
|
+
|
|
874
|
+
### Examples
|
|
875
|
+
|
|
876
|
+
|
|
877
|
+
(No example for this operation).
|
|
878
|
+
|
|
879
|
+
|
|
880
|
+
#### Using the create_sfvb_flow_with_http_info variant
|
|
881
|
+
|
|
882
|
+
This returns an Array which contains the response data, status code and headers.
|
|
883
|
+
|
|
884
|
+
> <Array(<SfvbFlow>, Integer, Hash)> create_sfvb_flow_with_http_info(storefront_oid, flow_write_request)
|
|
885
|
+
|
|
886
|
+
```ruby
|
|
887
|
+
begin
|
|
888
|
+
# Create a draft flow
|
|
889
|
+
data, status_code, headers = api_instance.create_sfvb_flow_with_http_info(storefront_oid, flow_write_request)
|
|
890
|
+
p status_code # => 2xx
|
|
891
|
+
p headers # => { ... }
|
|
892
|
+
p data # => <SfvbFlow>
|
|
893
|
+
rescue UltracartClient::ApiError => e
|
|
894
|
+
puts "Error when calling SfvbApi->create_sfvb_flow_with_http_info: #{e}"
|
|
895
|
+
end
|
|
896
|
+
```
|
|
897
|
+
|
|
898
|
+
### Parameters
|
|
899
|
+
|
|
900
|
+
| Name | Type | Description | Notes |
|
|
901
|
+
| ---- | ---- | ----------- | ----- |
|
|
902
|
+
| **storefront_oid** | **Integer** | | |
|
|
903
|
+
| **flow_write_request** | [**SfvbFlowWriteRequest**](SfvbFlowWriteRequest.md) | The flow to create | |
|
|
904
|
+
|
|
905
|
+
### Return type
|
|
906
|
+
|
|
907
|
+
[**SfvbFlow**](SfvbFlow.md)
|
|
908
|
+
|
|
909
|
+
### Authorization
|
|
910
|
+
|
|
911
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
912
|
+
|
|
913
|
+
### HTTP request headers
|
|
914
|
+
|
|
915
|
+
- **Content-Type**: application/json
|
|
916
|
+
- **Accept**: application/json
|
|
917
|
+
|
|
918
|
+
|
|
580
919
|
## create_sfvb_library_entry
|
|
581
920
|
|
|
582
921
|
> <SfvbLibraryEntry> create_sfvb_library_entry(storefront_oid, library_entry)
|
|
@@ -6429,6 +6768,112 @@ end
|
|
|
6429
6768
|
- **Accept**: application/json
|
|
6430
6769
|
|
|
6431
6770
|
|
|
6771
|
+
## list_sfvb_comms_lists
|
|
6772
|
+
|
|
6773
|
+
> <SfvbCommsListsResponse> list_sfvb_comms_lists(storefront_oid)
|
|
6774
|
+
|
|
6775
|
+
List the storefront's email lists
|
|
6776
|
+
|
|
6777
|
+
Each list's uuid, name and member count, by name, for a campaign's memberships or a list trigger. Never its members. Archived lists are left out.
|
|
6778
|
+
|
|
6779
|
+
|
|
6780
|
+
### Examples
|
|
6781
|
+
|
|
6782
|
+
|
|
6783
|
+
(No example for this operation).
|
|
6784
|
+
|
|
6785
|
+
|
|
6786
|
+
#### Using the list_sfvb_comms_lists_with_http_info variant
|
|
6787
|
+
|
|
6788
|
+
This returns an Array which contains the response data, status code and headers.
|
|
6789
|
+
|
|
6790
|
+
> <Array(<SfvbCommsListsResponse>, Integer, Hash)> list_sfvb_comms_lists_with_http_info(storefront_oid)
|
|
6791
|
+
|
|
6792
|
+
```ruby
|
|
6793
|
+
begin
|
|
6794
|
+
# List the storefront's email lists
|
|
6795
|
+
data, status_code, headers = api_instance.list_sfvb_comms_lists_with_http_info(storefront_oid)
|
|
6796
|
+
p status_code # => 2xx
|
|
6797
|
+
p headers # => { ... }
|
|
6798
|
+
p data # => <SfvbCommsListsResponse>
|
|
6799
|
+
rescue UltracartClient::ApiError => e
|
|
6800
|
+
puts "Error when calling SfvbApi->list_sfvb_comms_lists_with_http_info: #{e}"
|
|
6801
|
+
end
|
|
6802
|
+
```
|
|
6803
|
+
|
|
6804
|
+
### Parameters
|
|
6805
|
+
|
|
6806
|
+
| Name | Type | Description | Notes |
|
|
6807
|
+
| ---- | ---- | ----------- | ----- |
|
|
6808
|
+
| **storefront_oid** | **Integer** | | |
|
|
6809
|
+
|
|
6810
|
+
### Return type
|
|
6811
|
+
|
|
6812
|
+
[**SfvbCommsListsResponse**](SfvbCommsListsResponse.md)
|
|
6813
|
+
|
|
6814
|
+
### Authorization
|
|
6815
|
+
|
|
6816
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
6817
|
+
|
|
6818
|
+
### HTTP request headers
|
|
6819
|
+
|
|
6820
|
+
- **Content-Type**: Not defined
|
|
6821
|
+
- **Accept**: application/json
|
|
6822
|
+
|
|
6823
|
+
|
|
6824
|
+
## list_sfvb_comms_segments
|
|
6825
|
+
|
|
6826
|
+
> <SfvbCommsSegmentsResponse> list_sfvb_comms_segments(storefront_oid)
|
|
6827
|
+
|
|
6828
|
+
List the storefront's segments
|
|
6829
|
+
|
|
6830
|
+
Each segment's uuid, name and member count at its last rebuild, by name, for a campaign's memberships or a segment trigger. Never its members or its rule. Archived segments are left out.
|
|
6831
|
+
|
|
6832
|
+
|
|
6833
|
+
### Examples
|
|
6834
|
+
|
|
6835
|
+
|
|
6836
|
+
(No example for this operation).
|
|
6837
|
+
|
|
6838
|
+
|
|
6839
|
+
#### Using the list_sfvb_comms_segments_with_http_info variant
|
|
6840
|
+
|
|
6841
|
+
This returns an Array which contains the response data, status code and headers.
|
|
6842
|
+
|
|
6843
|
+
> <Array(<SfvbCommsSegmentsResponse>, Integer, Hash)> list_sfvb_comms_segments_with_http_info(storefront_oid)
|
|
6844
|
+
|
|
6845
|
+
```ruby
|
|
6846
|
+
begin
|
|
6847
|
+
# List the storefront's segments
|
|
6848
|
+
data, status_code, headers = api_instance.list_sfvb_comms_segments_with_http_info(storefront_oid)
|
|
6849
|
+
p status_code # => 2xx
|
|
6850
|
+
p headers # => { ... }
|
|
6851
|
+
p data # => <SfvbCommsSegmentsResponse>
|
|
6852
|
+
rescue UltracartClient::ApiError => e
|
|
6853
|
+
puts "Error when calling SfvbApi->list_sfvb_comms_segments_with_http_info: #{e}"
|
|
6854
|
+
end
|
|
6855
|
+
```
|
|
6856
|
+
|
|
6857
|
+
### Parameters
|
|
6858
|
+
|
|
6859
|
+
| Name | Type | Description | Notes |
|
|
6860
|
+
| ---- | ---- | ----------- | ----- |
|
|
6861
|
+
| **storefront_oid** | **Integer** | | |
|
|
6862
|
+
|
|
6863
|
+
### Return type
|
|
6864
|
+
|
|
6865
|
+
[**SfvbCommsSegmentsResponse**](SfvbCommsSegmentsResponse.md)
|
|
6866
|
+
|
|
6867
|
+
### Authorization
|
|
6868
|
+
|
|
6869
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
6870
|
+
|
|
6871
|
+
### HTTP request headers
|
|
6872
|
+
|
|
6873
|
+
- **Content-Type**: Not defined
|
|
6874
|
+
- **Accept**: application/json
|
|
6875
|
+
|
|
6876
|
+
|
|
6432
6877
|
## list_sfvb_container_versions
|
|
6433
6878
|
|
|
6434
6879
|
> <SfvbContainerVersionsResponse> list_sfvb_container_versions(storefront_oid, opts)
|
|
@@ -9972,6 +10417,62 @@ end
|
|
|
9972
10417
|
- **Accept**: application/json
|
|
9973
10418
|
|
|
9974
10419
|
|
|
10420
|
+
## update_sfvb_campaign
|
|
10421
|
+
|
|
10422
|
+
> <SfvbCampaign> update_sfvb_campaign(storefront_oid, campaign_uuid, if_match, campaign_write_request)
|
|
10423
|
+
|
|
10424
|
+
Change a campaign
|
|
10425
|
+
|
|
10426
|
+
A field left out keeps its value; memberships replaces the whole set. The status is never changed here. Send the hash_sha256 you read as If-Match. A scheduled, sending or sent campaign needs sfvb_publish, and a change to a scheduled one applies to the send that is coming. notes lists any emails a sending domain change put back to needing review.
|
|
10427
|
+
|
|
10428
|
+
|
|
10429
|
+
### Examples
|
|
10430
|
+
|
|
10431
|
+
|
|
10432
|
+
(No example for this operation).
|
|
10433
|
+
|
|
10434
|
+
|
|
10435
|
+
#### Using the update_sfvb_campaign_with_http_info variant
|
|
10436
|
+
|
|
10437
|
+
This returns an Array which contains the response data, status code and headers.
|
|
10438
|
+
|
|
10439
|
+
> <Array(<SfvbCampaign>, Integer, Hash)> update_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid, if_match, campaign_write_request)
|
|
10440
|
+
|
|
10441
|
+
```ruby
|
|
10442
|
+
begin
|
|
10443
|
+
# Change a campaign
|
|
10444
|
+
data, status_code, headers = api_instance.update_sfvb_campaign_with_http_info(storefront_oid, campaign_uuid, if_match, campaign_write_request)
|
|
10445
|
+
p status_code # => 2xx
|
|
10446
|
+
p headers # => { ... }
|
|
10447
|
+
p data # => <SfvbCampaign>
|
|
10448
|
+
rescue UltracartClient::ApiError => e
|
|
10449
|
+
puts "Error when calling SfvbApi->update_sfvb_campaign_with_http_info: #{e}"
|
|
10450
|
+
end
|
|
10451
|
+
```
|
|
10452
|
+
|
|
10453
|
+
### Parameters
|
|
10454
|
+
|
|
10455
|
+
| Name | Type | Description | Notes |
|
|
10456
|
+
| ---- | ---- | ----------- | ----- |
|
|
10457
|
+
| **storefront_oid** | **Integer** | | |
|
|
10458
|
+
| **campaign_uuid** | **String** | | |
|
|
10459
|
+
| **if_match** | **String** | hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
10460
|
+
| **campaign_write_request** | [**SfvbCampaignWriteRequest**](SfvbCampaignWriteRequest.md) | The fields to change | |
|
|
10461
|
+
|
|
10462
|
+
### Return type
|
|
10463
|
+
|
|
10464
|
+
[**SfvbCampaign**](SfvbCampaign.md)
|
|
10465
|
+
|
|
10466
|
+
### Authorization
|
|
10467
|
+
|
|
10468
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
10469
|
+
|
|
10470
|
+
### HTTP request headers
|
|
10471
|
+
|
|
10472
|
+
- **Content-Type**: application/json
|
|
10473
|
+
- **Accept**: application/json
|
|
10474
|
+
|
|
10475
|
+
|
|
9975
10476
|
## update_sfvb_comms_sending_domain
|
|
9976
10477
|
|
|
9977
10478
|
> <SfvbCommsSendingDomain> update_sfvb_comms_sending_domain(domain, sending_domain)
|
|
@@ -10135,6 +10636,118 @@ end
|
|
|
10135
10636
|
- **Accept**: application/json
|
|
10136
10637
|
|
|
10137
10638
|
|
|
10639
|
+
## update_sfvb_flow
|
|
10640
|
+
|
|
10641
|
+
> <SfvbFlow> update_sfvb_flow(storefront_oid, flow_uuid, if_match, flow_write_request)
|
|
10642
|
+
|
|
10643
|
+
Change a flow
|
|
10644
|
+
|
|
10645
|
+
A field left out keeps its value. The trigger and the status are never changed here. Send the hash_sha256 you read as If-Match. A flow that is enrolling customers needs sfvb_publish.
|
|
10646
|
+
|
|
10647
|
+
|
|
10648
|
+
### Examples
|
|
10649
|
+
|
|
10650
|
+
|
|
10651
|
+
(No example for this operation).
|
|
10652
|
+
|
|
10653
|
+
|
|
10654
|
+
#### Using the update_sfvb_flow_with_http_info variant
|
|
10655
|
+
|
|
10656
|
+
This returns an Array which contains the response data, status code and headers.
|
|
10657
|
+
|
|
10658
|
+
> <Array(<SfvbFlow>, Integer, Hash)> update_sfvb_flow_with_http_info(storefront_oid, flow_uuid, if_match, flow_write_request)
|
|
10659
|
+
|
|
10660
|
+
```ruby
|
|
10661
|
+
begin
|
|
10662
|
+
# Change a flow
|
|
10663
|
+
data, status_code, headers = api_instance.update_sfvb_flow_with_http_info(storefront_oid, flow_uuid, if_match, flow_write_request)
|
|
10664
|
+
p status_code # => 2xx
|
|
10665
|
+
p headers # => { ... }
|
|
10666
|
+
p data # => <SfvbFlow>
|
|
10667
|
+
rescue UltracartClient::ApiError => e
|
|
10668
|
+
puts "Error when calling SfvbApi->update_sfvb_flow_with_http_info: #{e}"
|
|
10669
|
+
end
|
|
10670
|
+
```
|
|
10671
|
+
|
|
10672
|
+
### Parameters
|
|
10673
|
+
|
|
10674
|
+
| Name | Type | Description | Notes |
|
|
10675
|
+
| ---- | ---- | ----------- | ----- |
|
|
10676
|
+
| **storefront_oid** | **Integer** | | |
|
|
10677
|
+
| **flow_uuid** | **String** | | |
|
|
10678
|
+
| **if_match** | **String** | hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
10679
|
+
| **flow_write_request** | [**SfvbFlowWriteRequest**](SfvbFlowWriteRequest.md) | The fields to change | |
|
|
10680
|
+
|
|
10681
|
+
### Return type
|
|
10682
|
+
|
|
10683
|
+
[**SfvbFlow**](SfvbFlow.md)
|
|
10684
|
+
|
|
10685
|
+
### Authorization
|
|
10686
|
+
|
|
10687
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
10688
|
+
|
|
10689
|
+
### HTTP request headers
|
|
10690
|
+
|
|
10691
|
+
- **Content-Type**: application/json
|
|
10692
|
+
- **Accept**: application/json
|
|
10693
|
+
|
|
10694
|
+
|
|
10695
|
+
## update_sfvb_flow_status
|
|
10696
|
+
|
|
10697
|
+
> <SfvbFlow> update_sfvb_flow_status(storefront_oid, flow_uuid, if_match, flow_status_request)
|
|
10698
|
+
|
|
10699
|
+
Turn a flow on or off
|
|
10700
|
+
|
|
10701
|
+
active enrolls customers as they trigger the flow from now on, and they receive its emails. inactive stops new enrollments. Always needs sfvb_publish. Send the hash_sha256 you read as If-Match.
|
|
10702
|
+
|
|
10703
|
+
|
|
10704
|
+
### Examples
|
|
10705
|
+
|
|
10706
|
+
|
|
10707
|
+
(No example for this operation).
|
|
10708
|
+
|
|
10709
|
+
|
|
10710
|
+
#### Using the update_sfvb_flow_status_with_http_info variant
|
|
10711
|
+
|
|
10712
|
+
This returns an Array which contains the response data, status code and headers.
|
|
10713
|
+
|
|
10714
|
+
> <Array(<SfvbFlow>, Integer, Hash)> update_sfvb_flow_status_with_http_info(storefront_oid, flow_uuid, if_match, flow_status_request)
|
|
10715
|
+
|
|
10716
|
+
```ruby
|
|
10717
|
+
begin
|
|
10718
|
+
# Turn a flow on or off
|
|
10719
|
+
data, status_code, headers = api_instance.update_sfvb_flow_status_with_http_info(storefront_oid, flow_uuid, if_match, flow_status_request)
|
|
10720
|
+
p status_code # => 2xx
|
|
10721
|
+
p headers # => { ... }
|
|
10722
|
+
p data # => <SfvbFlow>
|
|
10723
|
+
rescue UltracartClient::ApiError => e
|
|
10724
|
+
puts "Error when calling SfvbApi->update_sfvb_flow_status_with_http_info: #{e}"
|
|
10725
|
+
end
|
|
10726
|
+
```
|
|
10727
|
+
|
|
10728
|
+
### Parameters
|
|
10729
|
+
|
|
10730
|
+
| Name | Type | Description | Notes |
|
|
10731
|
+
| ---- | ---- | ----------- | ----- |
|
|
10732
|
+
| **storefront_oid** | **Integer** | | |
|
|
10733
|
+
| **flow_uuid** | **String** | | |
|
|
10734
|
+
| **if_match** | **String** | hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
10735
|
+
| **flow_status_request** | [**SfvbFlowStatusRequest**](SfvbFlowStatusRequest.md) | The status to set | |
|
|
10736
|
+
|
|
10737
|
+
### Return type
|
|
10738
|
+
|
|
10739
|
+
[**SfvbFlow**](SfvbFlow.md)
|
|
10740
|
+
|
|
10741
|
+
### Authorization
|
|
10742
|
+
|
|
10743
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
10744
|
+
|
|
10745
|
+
### HTTP request headers
|
|
10746
|
+
|
|
10747
|
+
- **Content-Type**: application/json
|
|
10748
|
+
- **Accept**: application/json
|
|
10749
|
+
|
|
10750
|
+
|
|
10138
10751
|
## update_sfvb_item_attribute_batch
|
|
10139
10752
|
|
|
10140
10753
|
> <SfvbItemAttributeBatchResponse> update_sfvb_item_attribute_batch(storefront_oid, item_attribute_batch_request, opts)
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbArchiveRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **archived** | **Boolean** | True to archive, false to unarchive. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbArchiveRequest.new(
|
|
15
|
+
archived: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|