ultracart_api 4.1.102 → 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 +15 -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/lib/ultracart_api/api/affiliate_api.rb +359 -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/version.rb +1 -1
- data/lib/ultracart_api.rb +7 -0
- metadata +16 -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
|
|
@@ -709,6 +714,8 @@ Class | Method | HTTP request | Description
|
|
|
709
714
|
- [UltracartClient::AddLibraryItemRequest](docs/AddLibraryItemRequest.md)
|
|
710
715
|
- [UltracartClient::AdjustInternalCertificateRequest](docs/AdjustInternalCertificateRequest.md)
|
|
711
716
|
- [UltracartClient::AdjustInternalCertificateResponse](docs/AdjustInternalCertificateResponse.md)
|
|
717
|
+
- [UltracartClient::Affiliate](docs/Affiliate.md)
|
|
718
|
+
- [UltracartClient::AffiliateAttribute](docs/AffiliateAttribute.md)
|
|
712
719
|
- [UltracartClient::AffiliateClick](docs/AffiliateClick.md)
|
|
713
720
|
- [UltracartClient::AffiliateClickQuery](docs/AffiliateClickQuery.md)
|
|
714
721
|
- [UltracartClient::AffiliateClicksResponse](docs/AffiliateClicksResponse.md)
|
|
@@ -716,6 +723,11 @@ Class | Method | HTTP request | Description
|
|
|
716
723
|
- [UltracartClient::AffiliateLedgerQuery](docs/AffiliateLedgerQuery.md)
|
|
717
724
|
- [UltracartClient::AffiliateLedgersResponse](docs/AffiliateLedgersResponse.md)
|
|
718
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)
|
|
719
731
|
- [UltracartClient::AgentSummary](docs/AgentSummary.md)
|
|
720
732
|
- [UltracartClient::ApiUserApplicationProfile](docs/ApiUserApplicationProfile.md)
|
|
721
733
|
- [UltracartClient::ApplyLibraryItemRequest](docs/ApplyLibraryItemRequest.md)
|
|
@@ -1780,6 +1792,7 @@ Not every change is committed to every SDK.
|
|
|
1780
1792
|
|
|
1781
1793
|
| Version | Date | Comments |
|
|
1782
1794
|
| --: | :-: | --- |
|
|
1795
|
+
| 4.1.103 | 06/18/2026 | affiliate api alpha |
|
|
1783
1796
|
| 4.1.102 | 06/17/2026 | storefront communications - new single email enrollment method |
|
|
1784
1797
|
| 4.1.101 | 06/10/2026 | conversation pbx call notes fields |
|
|
1785
1798
|
| 4.1.100 | 06/05/2026 | webhook log summary filtering |
|
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
|
+
|