ultracart_api 4.1.101 → 4.1.103
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 +19 -2
- data/docs/Affiliate.md +122 -0
- data/docs/AffiliateApi.md +277 -0
- data/docs/AffiliateAttribute.md +22 -0
- data/docs/AffiliateMarketingStrategy.md +38 -0
- data/docs/AffiliateQuery.md +38 -0
- data/docs/AffiliateResponse.md +26 -0
- data/docs/AffiliateTierRelationship.md +20 -0
- data/docs/AffiliatesResponse.md +26 -0
- data/docs/AutoOrderItem.md +4 -0
- data/docs/EmailCommseqEnrollmentRequest.md +22 -0
- data/docs/EmailCommseqEnrollmentResponse.md +30 -0
- data/docs/StorefrontApi.md +56 -0
- data/lib/ultracart_api/api/affiliate_api.rb +359 -0
- data/lib/ultracart_api/api/storefront_api.rb +81 -0
- data/lib/ultracart_api/models/affiliate.rb +804 -0
- data/lib/ultracart_api/models/affiliate_attribute.rb +240 -0
- data/lib/ultracart_api/models/affiliate_marketing_strategy.rb +320 -0
- data/lib/ultracart_api/models/affiliate_query.rb +489 -0
- data/lib/ultracart_api/models/affiliate_response.rb +256 -0
- data/lib/ultracart_api/models/affiliate_tier_relationship.rb +230 -0
- data/lib/ultracart_api/models/affiliates_response.rb +259 -0
- data/lib/ultracart_api/models/auto_order_item.rb +21 -1
- data/lib/ultracart_api/models/email_commseq_enrollment_request.rb +240 -0
- data/lib/ultracart_api/models/email_commseq_enrollment_response.rb +277 -0
- data/lib/ultracart_api/models/webhook.rb +30 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +9 -0
- metadata +20 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 34b115d828400c2a6827ff8224c251b7a98543a0e3d82e8e0286903361a19e5a
|
|
4
|
+
data.tar.gz: 6b39303a24be29373dbdac1d3e476c1bcf3caec3951860058495e55ac132de0d
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 24859f67f94d6fca28fdb38828cfacdb5ed6e36483485a091271cb01dbd764e4e6d94eaf60b69ce09d58f972c02346ea044c485d35f2987f502b8a076cfb5bc2
|
|
7
|
+
data.tar.gz: 8ddb6a724e0614622b72b4585697531bbc02473756635e3468f90dd39a939bb3771637028510e3807776f834831e6294979300f62b95b64cba041d1d0a7e8039
|
data/README.md
CHANGED
|
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
|
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
8
|
|
|
9
9
|
- API version: 2.0.0
|
|
10
|
-
- Package version: 4.1.
|
|
10
|
+
- Package version: 4.1.103
|
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
12
12
|
- For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
|
|
13
13
|
|
|
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
|
|
|
16
16
|
gemfile:
|
|
17
17
|
|
|
18
18
|
```shell
|
|
19
|
-
gem 'ultracart_api', '4.1.
|
|
19
|
+
gem 'ultracart_api', '4.1.103'
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
install:
|
|
@@ -82,8 +82,13 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
82
82
|
|
|
83
83
|
Class | Method | HTTP request | Description
|
|
84
84
|
------------ | ------------- | ------------- | -------------
|
|
85
|
+
*UltracartClient::AffiliateApi* | [**delete_affiliate**](docs/AffiliateApi.md#delete_affiliate) | **DELETE** /affiliate/affiliates/{affiliate_oid} | Delete an affiliate
|
|
86
|
+
*UltracartClient::AffiliateApi* | [**get_affiliate**](docs/AffiliateApi.md#get_affiliate) | **GET** /affiliate/affiliates/{affiliate_oid} | Retrieve an affiliate
|
|
87
|
+
*UltracartClient::AffiliateApi* | [**get_affiliates_by_query**](docs/AffiliateApi.md#get_affiliates_by_query) | **POST** /affiliate/affiliates/query | Retrieve affiliates
|
|
85
88
|
*UltracartClient::AffiliateApi* | [**get_clicks_by_query**](docs/AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks
|
|
86
89
|
*UltracartClient::AffiliateApi* | [**get_ledgers_by_query**](docs/AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries
|
|
90
|
+
*UltracartClient::AffiliateApi* | [**insert_affiliate**](docs/AffiliateApi.md#insert_affiliate) | **POST** /affiliate/affiliates | Insert an affiliate
|
|
91
|
+
*UltracartClient::AffiliateApi* | [**update_affiliate**](docs/AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate
|
|
87
92
|
*UltracartClient::AutoOrderApi* | [**cancel_auto_order_item_by_reference_order_id**](docs/AutoOrderApi.md#cancel_auto_order_item_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id}/items/original/{original_item_id}/cancel | Cancel a single item on an auto order
|
|
88
93
|
*UltracartClient::AutoOrderApi* | [**consolidate_auto_orders**](docs/AutoOrderApi.md#consolidate_auto_orders) | **PUT** /auto_order/auto_orders/{auto_order_oid}/consolidate | Consolidates multiple auto orders
|
|
89
94
|
*UltracartClient::AutoOrderApi* | [**establish_auto_order_by_reference_order_id**](docs/AutoOrderApi.md#establish_auto_order_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id} | Establish an auto order by referencing a regular order id
|
|
@@ -481,6 +486,7 @@ Class | Method | HTTP request | Description
|
|
|
481
486
|
*UltracartClient::StorefrontApi* | [**delete_screen_recording_segment**](docs/StorefrontApi.md#delete_screen_recording_segment) | **DELETE** /storefront/{storefront_oid}/screen_recordings/segments/{screen_recording_segment_oid} | Delete screen recording segment
|
|
482
487
|
*UltracartClient::StorefrontApi* | [**delete_twilio_account**](docs/StorefrontApi.md#delete_twilio_account) | **DELETE** /storefront/twilio/accounts/{esp_twilio_uuid} | delete Twilio account
|
|
483
488
|
*UltracartClient::StorefrontApi* | [**duplicate_library_item**](docs/StorefrontApi.md#duplicate_library_item) | **POST** /storefront/code_library/{library_item_oid}/duplicate | Duplicate library item.
|
|
489
|
+
*UltracartClient::StorefrontApi* | [**enroll_commseq_customer**](docs/StorefrontApi.md#enroll_commseq_customer) | **POST** /storefront/{storefront_oid}/email/commseqs/{commseq_uuid}/enroll | Enroll a customer into a communication sequence
|
|
484
490
|
*UltracartClient::StorefrontApi* | [**favorite_screen_recording**](docs/StorefrontApi.md#favorite_screen_recording) | **POST** /storefront/{storefront_oid}/screen_recordings/{screen_recording_uuid}/favorite | Update favorite flag on screen recording
|
|
485
491
|
*UltracartClient::StorefrontApi* | [**geocode_address**](docs/StorefrontApi.md#geocode_address) | **POST** /storefront/{storefront_oid}/email/geocode | Obtain lat/long for an address
|
|
486
492
|
*UltracartClient::StorefrontApi* | [**get_countries**](docs/StorefrontApi.md#get_countries) | **GET** /storefront/{storefront_oid}/email/countries | Get countries
|
|
@@ -708,6 +714,8 @@ Class | Method | HTTP request | Description
|
|
|
708
714
|
- [UltracartClient::AddLibraryItemRequest](docs/AddLibraryItemRequest.md)
|
|
709
715
|
- [UltracartClient::AdjustInternalCertificateRequest](docs/AdjustInternalCertificateRequest.md)
|
|
710
716
|
- [UltracartClient::AdjustInternalCertificateResponse](docs/AdjustInternalCertificateResponse.md)
|
|
717
|
+
- [UltracartClient::Affiliate](docs/Affiliate.md)
|
|
718
|
+
- [UltracartClient::AffiliateAttribute](docs/AffiliateAttribute.md)
|
|
711
719
|
- [UltracartClient::AffiliateClick](docs/AffiliateClick.md)
|
|
712
720
|
- [UltracartClient::AffiliateClickQuery](docs/AffiliateClickQuery.md)
|
|
713
721
|
- [UltracartClient::AffiliateClicksResponse](docs/AffiliateClicksResponse.md)
|
|
@@ -715,6 +723,11 @@ Class | Method | HTTP request | Description
|
|
|
715
723
|
- [UltracartClient::AffiliateLedgerQuery](docs/AffiliateLedgerQuery.md)
|
|
716
724
|
- [UltracartClient::AffiliateLedgersResponse](docs/AffiliateLedgersResponse.md)
|
|
717
725
|
- [UltracartClient::AffiliateLink](docs/AffiliateLink.md)
|
|
726
|
+
- [UltracartClient::AffiliateMarketingStrategy](docs/AffiliateMarketingStrategy.md)
|
|
727
|
+
- [UltracartClient::AffiliateQuery](docs/AffiliateQuery.md)
|
|
728
|
+
- [UltracartClient::AffiliateResponse](docs/AffiliateResponse.md)
|
|
729
|
+
- [UltracartClient::AffiliateTierRelationship](docs/AffiliateTierRelationship.md)
|
|
730
|
+
- [UltracartClient::AffiliatesResponse](docs/AffiliatesResponse.md)
|
|
718
731
|
- [UltracartClient::AgentSummary](docs/AgentSummary.md)
|
|
719
732
|
- [UltracartClient::ApiUserApplicationProfile](docs/ApiUserApplicationProfile.md)
|
|
720
733
|
- [UltracartClient::ApplyLibraryItemRequest](docs/ApplyLibraryItemRequest.md)
|
|
@@ -1162,6 +1175,8 @@ Class | Method | HTTP request | Description
|
|
|
1162
1175
|
- [UltracartClient::EmailCommseqEmailSendTestResponse](docs/EmailCommseqEmailSendTestResponse.md)
|
|
1163
1176
|
- [UltracartClient::EmailCommseqEmailsRequest](docs/EmailCommseqEmailsRequest.md)
|
|
1164
1177
|
- [UltracartClient::EmailCommseqEmailsResponse](docs/EmailCommseqEmailsResponse.md)
|
|
1178
|
+
- [UltracartClient::EmailCommseqEnrollmentRequest](docs/EmailCommseqEnrollmentRequest.md)
|
|
1179
|
+
- [UltracartClient::EmailCommseqEnrollmentResponse](docs/EmailCommseqEnrollmentResponse.md)
|
|
1165
1180
|
- [UltracartClient::EmailCommseqPostcard](docs/EmailCommseqPostcard.md)
|
|
1166
1181
|
- [UltracartClient::EmailCommseqPostcardResponse](docs/EmailCommseqPostcardResponse.md)
|
|
1167
1182
|
- [UltracartClient::EmailCommseqPostcardSendTestRequest](docs/EmailCommseqPostcardSendTestRequest.md)
|
|
@@ -1777,6 +1792,8 @@ Not every change is committed to every SDK.
|
|
|
1777
1792
|
|
|
1778
1793
|
| Version | Date | Comments |
|
|
1779
1794
|
| --: | :-: | --- |
|
|
1795
|
+
| 4.1.103 | 06/18/2026 | affiliate api alpha |
|
|
1796
|
+
| 4.1.102 | 06/17/2026 | storefront communications - new single email enrollment method |
|
|
1780
1797
|
| 4.1.101 | 06/10/2026 | conversation pbx call notes fields |
|
|
1781
1798
|
| 4.1.100 | 06/05/2026 | webhook log summary filtering |
|
|
1782
1799
|
| 4.1.99 | 06/05/2026 | added webhook name and merchant_comments |
|
data/docs/Affiliate.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# UltracartClient::Affiliate
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **accepted_downline_recruiting_terms** | **Boolean** | True if affiliate has agreed to the terms associated with recruiting downline affiliates | [optional] |
|
|
8
|
+
| **address_1** | **String** | Address 1 | [optional] |
|
|
9
|
+
| **address_2** | **String** | Address 2 | [optional] |
|
|
10
|
+
| **affiliate_commission_group_oid** | **Integer** | Commission group that this affiliate is assigned to | [optional] |
|
|
11
|
+
| **affiliate_oid** | **Integer** | Unique object identifier for this Affiliate | [optional] |
|
|
12
|
+
| **allow_downline_recruiting** | **Boolean** | True if affiliate is allowed to recruit downline affiliates | [optional] |
|
|
13
|
+
| **allow_google_adwords_tracking** | **Boolean** | True if the affiliate is allowed to have their Google Adwords tracking pixel on the receipt | [optional] |
|
|
14
|
+
| **allow_yahoo_search_marketing_tracking** | **Boolean** | True if the affiliate is allowed to have their Yahoo Search Marketing tracking pixel on the receipt | [optional] |
|
|
15
|
+
| **analytics_internal_tracking** | **Boolean** | True if this is used for internal tracking and should not influence UltraCart Analytics | [optional] |
|
|
16
|
+
| **attributes** | [**Array<AffiliateAttribute>**](AffiliateAttribute.md) | Custom attributes about the affiliate that can be used in the catalog/StoreFront | [optional] |
|
|
17
|
+
| **auto_apply_coupon_code** | **String** | Coupon code to automatically apply when this affiliate sends traffic | [optional] |
|
|
18
|
+
| **auto_apply_coupon_oid** | **Integer** | Coupon object id to automatically apply when this affiliate sends traffic | [optional] |
|
|
19
|
+
| **auto_approve_commissions** | **Boolean** | True if this affiliates commissions are automatically approved | [optional] |
|
|
20
|
+
| **check_payable_to** | **String** | If the affiliate wants to be paid by check instead of PayPal, then this is the name to make the check out to | [optional] |
|
|
21
|
+
| **city** | **String** | City | [optional] |
|
|
22
|
+
| **company_name** | **String** | Company Name | [optional] |
|
|
23
|
+
| **cookie_ttl** | **Integer** | Number of days the affiliate tracking cookie lasts before expiring | [optional] |
|
|
24
|
+
| **country_code** | **String** | ISO-3166 two letter country code | [optional] |
|
|
25
|
+
| **dob** | **String** | Date of birth | [optional] |
|
|
26
|
+
| **email** | **String** | Email | [optional] |
|
|
27
|
+
| **email_notification_schedule** | **String** | Email notification of transactions | [optional] |
|
|
28
|
+
| **fax** | **String** | Fax | [optional] |
|
|
29
|
+
| **first_name** | **String** | First Name | [optional] |
|
|
30
|
+
| **google_conversion_id** | **String** | Google Adwords conversion id to use for the tracking pixel | [optional] |
|
|
31
|
+
| **html_permitted** | **Boolean** | True if the affiliate is allowed to specify custom HTML to render on the receipt | [optional] |
|
|
32
|
+
| **last_name** | **String** | Last Name | [optional] |
|
|
33
|
+
| **last_terms_acceptance** | **String** | Last date/time the affiliate program terms were agreed to | [optional] |
|
|
34
|
+
| **marketing_strategy** | [**AffiliateMarketingStrategy**](AffiliateMarketingStrategy.md) | | [optional] |
|
|
35
|
+
| **member_type** | **Integer** | Member type object identifier the affiliate is assigned to within the program | [optional] |
|
|
36
|
+
| **merchant_id** | **String** | Merchant ID | [optional] |
|
|
37
|
+
| **minimum_payout** | **Float** | Minimum balance that must accrue before the affiliate is paid | [optional] |
|
|
38
|
+
| **password** | **String** | Password (can only be used to update) | [optional] |
|
|
39
|
+
| **pay_commissions_on_auto_orders** | **Boolean** | True if commissions are paid on auto order (rebill) transactions | [optional] |
|
|
40
|
+
| **pay_commissions_on_repeat_orders_by_email** | **Boolean** | True if commissions are paid on repeat orders matched by customer email | [optional] |
|
|
41
|
+
| **pay_via_paypal** | **Boolean** | True if the affiliate is paid via PayPal | [optional] |
|
|
42
|
+
| **payment_adjustment** | **Float** | Fixed adjustment applied to the affiliate's commission payments | [optional] |
|
|
43
|
+
| **paypal_email** | **String** | Alternate email address to use for their PayPal payment if different than their primary email | [optional] |
|
|
44
|
+
| **phone** | **String** | Phone | [optional] |
|
|
45
|
+
| **postal_code** | **String** | Postal Code | [optional] |
|
|
46
|
+
| **prevent_cookie_stomping** | **Boolean** | True if cookie stomping of this affiliate is prevented | [optional] |
|
|
47
|
+
| **prevent_sending_all_emails** | **Boolean** | If true, affiliate will not receive any email notifications. | [optional] |
|
|
48
|
+
| **refund_server_to_server_postback_url** | **String** | Server to server postback URL notified of affiliate refunds | [optional] |
|
|
49
|
+
| **remove_cookie_after_purchase** | **Boolean** | If true, affiliate cookies are removed after a purchase. | [optional] |
|
|
50
|
+
| **salesforce_account_id** | **String** | Salesforce.com account id | [optional] |
|
|
51
|
+
| **salesforce_contact_id** | **String** | Salesforce.com contact id | [optional] |
|
|
52
|
+
| **server_to_server_postback_url** | **String** | Server to server postback URL notified of affiliate transactions | [optional] |
|
|
53
|
+
| **short_code** | **String** | Short code that can be used in place of the affiliate id within tracking links | [optional] |
|
|
54
|
+
| **state** | **String** | State | [optional] |
|
|
55
|
+
| **status** | **String** | Status | [optional] |
|
|
56
|
+
| **tax_id** | **String** | Tax ID (can only be used to update) | [optional] |
|
|
57
|
+
| **terminated_for_spam** | **Boolean** | True if the affiliate has been terminated for spamming | [optional] |
|
|
58
|
+
| **tier_relationships** | [**Array<AffiliateTierRelationship>**](AffiliateTierRelationship.md) | Relationship with other affiliates that recruted this affiliate | [optional] |
|
|
59
|
+
| **ysm_account_id** | **String** | Yahoo Search Marketing account id to use for the tracking pixel | [optional] |
|
|
60
|
+
|
|
61
|
+
## Example
|
|
62
|
+
|
|
63
|
+
```ruby
|
|
64
|
+
require 'ultracart_api'
|
|
65
|
+
|
|
66
|
+
instance = UltracartClient::Affiliate.new(
|
|
67
|
+
accepted_downline_recruiting_terms: null,
|
|
68
|
+
address_1: null,
|
|
69
|
+
address_2: null,
|
|
70
|
+
affiliate_commission_group_oid: null,
|
|
71
|
+
affiliate_oid: null,
|
|
72
|
+
allow_downline_recruiting: null,
|
|
73
|
+
allow_google_adwords_tracking: null,
|
|
74
|
+
allow_yahoo_search_marketing_tracking: null,
|
|
75
|
+
analytics_internal_tracking: null,
|
|
76
|
+
attributes: null,
|
|
77
|
+
auto_apply_coupon_code: null,
|
|
78
|
+
auto_apply_coupon_oid: null,
|
|
79
|
+
auto_approve_commissions: null,
|
|
80
|
+
check_payable_to: null,
|
|
81
|
+
city: null,
|
|
82
|
+
company_name: null,
|
|
83
|
+
cookie_ttl: null,
|
|
84
|
+
country_code: null,
|
|
85
|
+
dob: null,
|
|
86
|
+
email: null,
|
|
87
|
+
email_notification_schedule: null,
|
|
88
|
+
fax: null,
|
|
89
|
+
first_name: null,
|
|
90
|
+
google_conversion_id: null,
|
|
91
|
+
html_permitted: null,
|
|
92
|
+
last_name: null,
|
|
93
|
+
last_terms_acceptance: null,
|
|
94
|
+
marketing_strategy: null,
|
|
95
|
+
member_type: null,
|
|
96
|
+
merchant_id: null,
|
|
97
|
+
minimum_payout: null,
|
|
98
|
+
password: null,
|
|
99
|
+
pay_commissions_on_auto_orders: null,
|
|
100
|
+
pay_commissions_on_repeat_orders_by_email: null,
|
|
101
|
+
pay_via_paypal: null,
|
|
102
|
+
payment_adjustment: null,
|
|
103
|
+
paypal_email: null,
|
|
104
|
+
phone: null,
|
|
105
|
+
postal_code: null,
|
|
106
|
+
prevent_cookie_stomping: null,
|
|
107
|
+
prevent_sending_all_emails: null,
|
|
108
|
+
refund_server_to_server_postback_url: null,
|
|
109
|
+
remove_cookie_after_purchase: null,
|
|
110
|
+
salesforce_account_id: null,
|
|
111
|
+
salesforce_contact_id: null,
|
|
112
|
+
server_to_server_postback_url: null,
|
|
113
|
+
short_code: null,
|
|
114
|
+
state: null,
|
|
115
|
+
status: null,
|
|
116
|
+
tax_id: null,
|
|
117
|
+
terminated_for_spam: null,
|
|
118
|
+
tier_relationships: null,
|
|
119
|
+
ysm_account_id: null
|
|
120
|
+
)
|
|
121
|
+
```
|
|
122
|
+
|
data/docs/AffiliateApi.md
CHANGED
|
@@ -4,8 +4,176 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
4
4
|
|
|
5
5
|
| Method | HTTP request | Description |
|
|
6
6
|
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**delete_affiliate**](AffiliateApi.md#delete_affiliate) | **DELETE** /affiliate/affiliates/{affiliate_oid} | Delete an affiliate |
|
|
8
|
+
| [**get_affiliate**](AffiliateApi.md#get_affiliate) | **GET** /affiliate/affiliates/{affiliate_oid} | Retrieve an affiliate |
|
|
9
|
+
| [**get_affiliates_by_query**](AffiliateApi.md#get_affiliates_by_query) | **POST** /affiliate/affiliates/query | Retrieve affiliates |
|
|
7
10
|
| [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
|
|
8
11
|
| [**get_ledgers_by_query**](AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries |
|
|
12
|
+
| [**insert_affiliate**](AffiliateApi.md#insert_affiliate) | **POST** /affiliate/affiliates | Insert an affiliate |
|
|
13
|
+
| [**update_affiliate**](AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate |
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
## delete_affiliate
|
|
17
|
+
|
|
18
|
+
> delete_affiliate(affiliate_oid)
|
|
19
|
+
|
|
20
|
+
Delete an affiliate
|
|
21
|
+
|
|
22
|
+
Delete an affiliate on the UltraCart account. The affiliate is disabled within the active affiliate program; their ledger and click history is preserved.
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
### Examples
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
(No example for this operation).
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
#### Using the delete_affiliate_with_http_info variant
|
|
32
|
+
|
|
33
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
34
|
+
|
|
35
|
+
> <Array(nil, Integer, Hash)> delete_affiliate_with_http_info(affiliate_oid)
|
|
36
|
+
|
|
37
|
+
```ruby
|
|
38
|
+
begin
|
|
39
|
+
# Delete an affiliate
|
|
40
|
+
data, status_code, headers = api_instance.delete_affiliate_with_http_info(affiliate_oid)
|
|
41
|
+
p status_code # => 2xx
|
|
42
|
+
p headers # => { ... }
|
|
43
|
+
p data # => nil
|
|
44
|
+
rescue UltracartClient::ApiError => e
|
|
45
|
+
puts "Error when calling AffiliateApi->delete_affiliate_with_http_info: #{e}"
|
|
46
|
+
end
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Parameters
|
|
50
|
+
|
|
51
|
+
| Name | Type | Description | Notes |
|
|
52
|
+
| ---- | ---- | ----------- | ----- |
|
|
53
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to delete. | |
|
|
54
|
+
|
|
55
|
+
### Return type
|
|
56
|
+
|
|
57
|
+
nil (empty response body)
|
|
58
|
+
|
|
59
|
+
### Authorization
|
|
60
|
+
|
|
61
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
62
|
+
|
|
63
|
+
### HTTP request headers
|
|
64
|
+
|
|
65
|
+
- **Content-Type**: Not defined
|
|
66
|
+
- **Accept**: application/json
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## get_affiliate
|
|
70
|
+
|
|
71
|
+
> <AffiliateResponse> get_affiliate(affiliate_oid, opts)
|
|
72
|
+
|
|
73
|
+
Retrieve an affiliate
|
|
74
|
+
|
|
75
|
+
Retrieves a single affiliate using the specified affiliate oid.
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
### Examples
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
(No example for this operation).
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
#### Using the get_affiliate_with_http_info variant
|
|
85
|
+
|
|
86
|
+
This returns an Array which contains the response data, status code and headers.
|
|
87
|
+
|
|
88
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> get_affiliate_with_http_info(affiliate_oid, opts)
|
|
89
|
+
|
|
90
|
+
```ruby
|
|
91
|
+
begin
|
|
92
|
+
# Retrieve an affiliate
|
|
93
|
+
data, status_code, headers = api_instance.get_affiliate_with_http_info(affiliate_oid, opts)
|
|
94
|
+
p status_code # => 2xx
|
|
95
|
+
p headers # => { ... }
|
|
96
|
+
p data # => <AffiliateResponse>
|
|
97
|
+
rescue UltracartClient::ApiError => e
|
|
98
|
+
puts "Error when calling AffiliateApi->get_affiliate_with_http_info: #{e}"
|
|
99
|
+
end
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### Parameters
|
|
103
|
+
|
|
104
|
+
| Name | Type | Description | Notes |
|
|
105
|
+
| ---- | ---- | ----------- | ----- |
|
|
106
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to retrieve. | |
|
|
107
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
108
|
+
|
|
109
|
+
### Return type
|
|
110
|
+
|
|
111
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
112
|
+
|
|
113
|
+
### Authorization
|
|
114
|
+
|
|
115
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
116
|
+
|
|
117
|
+
### HTTP request headers
|
|
118
|
+
|
|
119
|
+
- **Content-Type**: Not defined
|
|
120
|
+
- **Accept**: application/json
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
## get_affiliates_by_query
|
|
124
|
+
|
|
125
|
+
> <AffiliatesResponse> get_affiliates_by_query(affiliate_query, opts)
|
|
126
|
+
|
|
127
|
+
Retrieve affiliates
|
|
128
|
+
|
|
129
|
+
Retrieves a group of affiliates from the account based on a query object. If no parameters are specified, the API call will fail with a bad request error. Always specify some parameters to limit the scope of the affiliates returned to ones you are truly interested in. You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination.
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
### Examples
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
(No example for this operation).
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
#### Using the get_affiliates_by_query_with_http_info variant
|
|
139
|
+
|
|
140
|
+
This returns an Array which contains the response data, status code and headers.
|
|
141
|
+
|
|
142
|
+
> <Array(<AffiliatesResponse>, Integer, Hash)> get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
143
|
+
|
|
144
|
+
```ruby
|
|
145
|
+
begin
|
|
146
|
+
# Retrieve affiliates
|
|
147
|
+
data, status_code, headers = api_instance.get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
148
|
+
p status_code # => 2xx
|
|
149
|
+
p headers # => { ... }
|
|
150
|
+
p data # => <AffiliatesResponse>
|
|
151
|
+
rescue UltracartClient::ApiError => e
|
|
152
|
+
puts "Error when calling AffiliateApi->get_affiliates_by_query_with_http_info: #{e}"
|
|
153
|
+
end
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### Parameters
|
|
157
|
+
|
|
158
|
+
| Name | Type | Description | Notes |
|
|
159
|
+
| ---- | ---- | ----------- | ----- |
|
|
160
|
+
| **affiliate_query** | [**AffiliateQuery**](AffiliateQuery.md) | Affiliate query | |
|
|
161
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
162
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
163
|
+
| **_sort** | **String** | The sort order of the affiliates. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
|
|
164
|
+
|
|
165
|
+
### Return type
|
|
166
|
+
|
|
167
|
+
[**AffiliatesResponse**](AffiliatesResponse.md)
|
|
168
|
+
|
|
169
|
+
### Authorization
|
|
170
|
+
|
|
171
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
172
|
+
|
|
173
|
+
### HTTP request headers
|
|
174
|
+
|
|
175
|
+
- **Content-Type**: application/json
|
|
176
|
+
- **Accept**: application/json
|
|
9
177
|
|
|
10
178
|
|
|
11
179
|
## get_clicks_by_query
|
|
@@ -121,3 +289,112 @@ end
|
|
|
121
289
|
- **Content-Type**: application/json
|
|
122
290
|
- **Accept**: application/json
|
|
123
291
|
|
|
292
|
+
|
|
293
|
+
## insert_affiliate
|
|
294
|
+
|
|
295
|
+
> <AffiliateResponse> insert_affiliate(affiliate, opts)
|
|
296
|
+
|
|
297
|
+
Insert an affiliate
|
|
298
|
+
|
|
299
|
+
Insert an affiliate on the UltraCart account. The affiliate is created within the merchant's active affiliate program.
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
### Examples
|
|
303
|
+
|
|
304
|
+
|
|
305
|
+
(No example for this operation).
|
|
306
|
+
|
|
307
|
+
|
|
308
|
+
#### Using the insert_affiliate_with_http_info variant
|
|
309
|
+
|
|
310
|
+
This returns an Array which contains the response data, status code and headers.
|
|
311
|
+
|
|
312
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> insert_affiliate_with_http_info(affiliate, opts)
|
|
313
|
+
|
|
314
|
+
```ruby
|
|
315
|
+
begin
|
|
316
|
+
# Insert an affiliate
|
|
317
|
+
data, status_code, headers = api_instance.insert_affiliate_with_http_info(affiliate, opts)
|
|
318
|
+
p status_code # => 2xx
|
|
319
|
+
p headers # => { ... }
|
|
320
|
+
p data # => <AffiliateResponse>
|
|
321
|
+
rescue UltracartClient::ApiError => e
|
|
322
|
+
puts "Error when calling AffiliateApi->insert_affiliate_with_http_info: #{e}"
|
|
323
|
+
end
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
### Parameters
|
|
327
|
+
|
|
328
|
+
| Name | Type | Description | Notes |
|
|
329
|
+
| ---- | ---- | ----------- | ----- |
|
|
330
|
+
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to insert | |
|
|
331
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
332
|
+
|
|
333
|
+
### Return type
|
|
334
|
+
|
|
335
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
336
|
+
|
|
337
|
+
### Authorization
|
|
338
|
+
|
|
339
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
340
|
+
|
|
341
|
+
### HTTP request headers
|
|
342
|
+
|
|
343
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
344
|
+
- **Accept**: application/json
|
|
345
|
+
|
|
346
|
+
|
|
347
|
+
## update_affiliate
|
|
348
|
+
|
|
349
|
+
> <AffiliateResponse> update_affiliate(affiliate_oid, affiliate, opts)
|
|
350
|
+
|
|
351
|
+
Update an affiliate
|
|
352
|
+
|
|
353
|
+
Update an affiliate on the UltraCart account. This is a full replacement of the affiliate; omitted fields are reset to their defaults, with the exception of password which is only changed when supplied.
|
|
354
|
+
|
|
355
|
+
|
|
356
|
+
### Examples
|
|
357
|
+
|
|
358
|
+
|
|
359
|
+
(No example for this operation).
|
|
360
|
+
|
|
361
|
+
|
|
362
|
+
#### Using the update_affiliate_with_http_info variant
|
|
363
|
+
|
|
364
|
+
This returns an Array which contains the response data, status code and headers.
|
|
365
|
+
|
|
366
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
367
|
+
|
|
368
|
+
```ruby
|
|
369
|
+
begin
|
|
370
|
+
# Update an affiliate
|
|
371
|
+
data, status_code, headers = api_instance.update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
372
|
+
p status_code # => 2xx
|
|
373
|
+
p headers # => { ... }
|
|
374
|
+
p data # => <AffiliateResponse>
|
|
375
|
+
rescue UltracartClient::ApiError => e
|
|
376
|
+
puts "Error when calling AffiliateApi->update_affiliate_with_http_info: #{e}"
|
|
377
|
+
end
|
|
378
|
+
```
|
|
379
|
+
|
|
380
|
+
### Parameters
|
|
381
|
+
|
|
382
|
+
| Name | Type | Description | Notes |
|
|
383
|
+
| ---- | ---- | ----------- | ----- |
|
|
384
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to update. | |
|
|
385
|
+
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to update | |
|
|
386
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
387
|
+
|
|
388
|
+
### Return type
|
|
389
|
+
|
|
390
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
391
|
+
|
|
392
|
+
### Authorization
|
|
393
|
+
|
|
394
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
395
|
+
|
|
396
|
+
### HTTP request headers
|
|
397
|
+
|
|
398
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
399
|
+
- **Accept**: application/json
|
|
400
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::AffiliateAttribute
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **name** | **String** | Name of the attribute | [optional] |
|
|
8
|
+
| **type** | **String** | Type of the attribute | [optional] |
|
|
9
|
+
| **value** | **String** | Value of the attribute | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::AffiliateAttribute.new(
|
|
17
|
+
name: null,
|
|
18
|
+
type: null,
|
|
19
|
+
value: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# UltracartClient::AffiliateMarketingStrategy
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **marketing_strategy** | **String** | Description of their marketing strategy | [optional] |
|
|
8
|
+
| **using_ad_network** | **Boolean** | True if they are using an ad network | [optional] |
|
|
9
|
+
| **using_adware** | **Boolean** | True if they are using ad software | [optional] |
|
|
10
|
+
| **using_blog** | **Boolean** | True if they are using their blog | [optional] |
|
|
11
|
+
| **using_other** | **String** | True if they are using some ohter marketing technique | [optional] |
|
|
12
|
+
| **using_per_acquisition** | **Boolean** | True if they are using a per acquisition model | [optional] |
|
|
13
|
+
| **using_ppc** | **Boolean** | True if they are using pay per click ads | [optional] |
|
|
14
|
+
| **using_seo** | **Boolean** | True if they are using search engine optimization techniques | [optional] |
|
|
15
|
+
| **using_website** | **Boolean** | True if they are driving traffic from their website | [optional] |
|
|
16
|
+
| **website_name** | **String** | Name of the affiliates website | [optional] |
|
|
17
|
+
| **website_url** | **String** | URL of the affiliates website | [optional] |
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```ruby
|
|
22
|
+
require 'ultracart_api'
|
|
23
|
+
|
|
24
|
+
instance = UltracartClient::AffiliateMarketingStrategy.new(
|
|
25
|
+
marketing_strategy: null,
|
|
26
|
+
using_ad_network: null,
|
|
27
|
+
using_adware: null,
|
|
28
|
+
using_blog: null,
|
|
29
|
+
using_other: null,
|
|
30
|
+
using_per_acquisition: null,
|
|
31
|
+
using_ppc: null,
|
|
32
|
+
using_seo: null,
|
|
33
|
+
using_website: null,
|
|
34
|
+
website_name: null,
|
|
35
|
+
website_url: null
|
|
36
|
+
)
|
|
37
|
+
```
|
|
38
|
+
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# UltracartClient::AffiliateQuery
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliate_oid** | **Integer** | Affiliate OID | [optional] |
|
|
8
|
+
| **city** | **String** | City | [optional] |
|
|
9
|
+
| **company_name** | **String** | Company name | [optional] |
|
|
10
|
+
| **country_code** | **String** | ISO-3166 two letter country code | [optional] |
|
|
11
|
+
| **email** | **String** | Email | [optional] |
|
|
12
|
+
| **first_name** | **String** | First name | [optional] |
|
|
13
|
+
| **last_name** | **String** | Last name | [optional] |
|
|
14
|
+
| **postal_code** | **String** | Postal code | [optional] |
|
|
15
|
+
| **short_code** | **String** | StoreFront short code | [optional] |
|
|
16
|
+
| **state** | **String** | State for United States otherwise region or province for other countries | [optional] |
|
|
17
|
+
| **status** | **String** | Status | [optional] |
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```ruby
|
|
22
|
+
require 'ultracart_api'
|
|
23
|
+
|
|
24
|
+
instance = UltracartClient::AffiliateQuery.new(
|
|
25
|
+
affiliate_oid: null,
|
|
26
|
+
city: null,
|
|
27
|
+
company_name: null,
|
|
28
|
+
country_code: null,
|
|
29
|
+
email: null,
|
|
30
|
+
first_name: null,
|
|
31
|
+
last_name: null,
|
|
32
|
+
postal_code: null,
|
|
33
|
+
short_code: null,
|
|
34
|
+
state: null,
|
|
35
|
+
status: null
|
|
36
|
+
)
|
|
37
|
+
```
|
|
38
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::AffiliateResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliate** | [**Affiliate**](Affiliate.md) | | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::AffiliateResponse.new(
|
|
19
|
+
affiliate: null,
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# UltracartClient::AffiliateTierRelationship
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliate_oid** | **Integer** | Affiliate object ID that recruited the affiliate | [optional] |
|
|
8
|
+
| **tier_number** | **Integer** | Tier number | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'ultracart_api'
|
|
14
|
+
|
|
15
|
+
instance = UltracartClient::AffiliateTierRelationship.new(
|
|
16
|
+
affiliate_oid: null,
|
|
17
|
+
tier_number: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::AffiliatesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **affiliates** | [**Array<Affiliate>**](Affiliate.md) | affiliates | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::AffiliatesResponse.new(
|
|
19
|
+
affiliates: null,
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|