ultracart_api 4.1.163 → 4.1.166
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/LICENSE +201 -201
- data/README.md +611 -602
- data/docs/AffiliateApi.md +455 -455
- data/docs/AutoOrderApi.md +1694 -1694
- data/docs/BulkApi.md +335 -335
- data/docs/ChannelPartnerApi.md +1678 -1678
- data/docs/CheckoutApi.md +1622 -1622
- data/docs/ConversationApi.md +7867 -7867
- data/docs/ConversationEmbedApi.md +226 -226
- data/docs/CouponApi.md +1522 -1522
- data/docs/CustomerApi.md +2849 -2849
- data/docs/DatawarehouseApi.md +1637 -1637
- data/docs/EmailCommseqEmailReviewStatus.md +32 -0
- data/docs/EmailCommseqEmailReviewStatusResponse.md +26 -0
- data/docs/EmailCommseqEmailReviewStatusesRequest.md +18 -0
- data/docs/EmailCommseqEmailReviewStatusesResponse.md +26 -0
- data/docs/FraudApi.md +332 -332
- data/docs/FulfillmentApi.md +567 -567
- data/docs/GiftCertificateApi.md +617 -617
- data/docs/IntegrationLogApi.md +290 -290
- data/docs/ItemApi.md +2502 -2502
- data/docs/OauthApi.md +311 -311
- data/docs/OrderApi.md +3396 -3396
- data/docs/SfvbApi.md +3883 -3883
- data/docs/SsoApi.md +223 -223
- data/docs/StorefrontApi.md +10143 -10035
- data/docs/TaxApi.md +1699 -1699
- data/docs/UserApi.md +606 -606
- data/docs/WebhookApi.md +840 -840
- data/docs/WorkflowApi.md +666 -666
- data/lib/ultracart_api/api/storefront_api.rb +143 -0
- data/lib/ultracart_api/models/email_commseq_email_review_status.rb +324 -0
- data/lib/ultracart_api/models/email_commseq_email_review_status_response.rb +256 -0
- data/lib/ultracart_api/models/email_commseq_email_review_statuses_request.rb +222 -0
- data/lib/ultracart_api/models/email_commseq_email_review_statuses_response.rb +258 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +4 -0
- metadata +11 -3
data/docs/AffiliateApi.md
CHANGED
|
@@ -1,455 +1,455 @@
|
|
|
1
|
-
# UltracartClient::AffiliateApi
|
|
2
|
-
|
|
3
|
-
All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
4
|
-
|
|
5
|
-
| Method | HTTP request | Description |
|
|
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 |
|
|
10
|
-
| [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
|
|
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
|
-
| [**send_affiliate_welcome_email**](AffiliateApi.md#send_affiliate_welcome_email) | **POST** /affiliate/affiliates/{affiliate_oid}/welcome_email | Send a welcome email to an affiliate |
|
|
14
|
-
| [**update_affiliate**](AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate |
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
## delete_affiliate
|
|
18
|
-
|
|
19
|
-
> delete_affiliate(affiliate_oid)
|
|
20
|
-
|
|
21
|
-
Delete an affiliate
|
|
22
|
-
|
|
23
|
-
Delete an affiliate on the UltraCart account. The affiliate is disabled within the active affiliate program; their ledger and click history is preserved.
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
### Examples
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
(No example for this operation).
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
#### Using the delete_affiliate_with_http_info variant
|
|
33
|
-
|
|
34
|
-
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
35
|
-
|
|
36
|
-
> <Array(nil, Integer, Hash)> delete_affiliate_with_http_info(affiliate_oid)
|
|
37
|
-
|
|
38
|
-
```ruby
|
|
39
|
-
begin
|
|
40
|
-
# Delete an affiliate
|
|
41
|
-
data, status_code, headers = api_instance.delete_affiliate_with_http_info(affiliate_oid)
|
|
42
|
-
p status_code # => 2xx
|
|
43
|
-
p headers # => { ... }
|
|
44
|
-
p data # => nil
|
|
45
|
-
rescue UltracartClient::ApiError => e
|
|
46
|
-
puts "Error when calling AffiliateApi->delete_affiliate_with_http_info: #{e}"
|
|
47
|
-
end
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### Parameters
|
|
51
|
-
|
|
52
|
-
| Name | Type | Description | Notes |
|
|
53
|
-
| ---- | ---- | ----------- | ----- |
|
|
54
|
-
| **affiliate_oid** | **Integer** | The affiliate oid to delete. | |
|
|
55
|
-
|
|
56
|
-
### Return type
|
|
57
|
-
|
|
58
|
-
nil (empty response body)
|
|
59
|
-
|
|
60
|
-
### Authorization
|
|
61
|
-
|
|
62
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
63
|
-
|
|
64
|
-
### HTTP request headers
|
|
65
|
-
|
|
66
|
-
- **Content-Type**: Not defined
|
|
67
|
-
- **Accept**: application/json
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
## get_affiliate
|
|
71
|
-
|
|
72
|
-
> <AffiliateResponse> get_affiliate(affiliate_oid, opts)
|
|
73
|
-
|
|
74
|
-
Retrieve an affiliate
|
|
75
|
-
|
|
76
|
-
Retrieves a single affiliate using the specified affiliate oid.
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
### Examples
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
(No example for this operation).
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
#### Using the get_affiliate_with_http_info variant
|
|
86
|
-
|
|
87
|
-
This returns an Array which contains the response data, status code and headers.
|
|
88
|
-
|
|
89
|
-
> <Array(<AffiliateResponse>, Integer, Hash)> get_affiliate_with_http_info(affiliate_oid, opts)
|
|
90
|
-
|
|
91
|
-
```ruby
|
|
92
|
-
begin
|
|
93
|
-
# Retrieve an affiliate
|
|
94
|
-
data, status_code, headers = api_instance.get_affiliate_with_http_info(affiliate_oid, opts)
|
|
95
|
-
p status_code # => 2xx
|
|
96
|
-
p headers # => { ... }
|
|
97
|
-
p data # => <AffiliateResponse>
|
|
98
|
-
rescue UltracartClient::ApiError => e
|
|
99
|
-
puts "Error when calling AffiliateApi->get_affiliate_with_http_info: #{e}"
|
|
100
|
-
end
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
### Parameters
|
|
104
|
-
|
|
105
|
-
| Name | Type | Description | Notes |
|
|
106
|
-
| ---- | ---- | ----------- | ----- |
|
|
107
|
-
| **affiliate_oid** | **Integer** | The affiliate oid to retrieve. | |
|
|
108
|
-
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
109
|
-
|
|
110
|
-
### Return type
|
|
111
|
-
|
|
112
|
-
[**AffiliateResponse**](AffiliateResponse.md)
|
|
113
|
-
|
|
114
|
-
### Authorization
|
|
115
|
-
|
|
116
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
117
|
-
|
|
118
|
-
### HTTP request headers
|
|
119
|
-
|
|
120
|
-
- **Content-Type**: Not defined
|
|
121
|
-
- **Accept**: application/json
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
## get_affiliates_by_query
|
|
125
|
-
|
|
126
|
-
> <AffiliatesResponse> get_affiliates_by_query(affiliate_query, opts)
|
|
127
|
-
|
|
128
|
-
Retrieve affiliates
|
|
129
|
-
|
|
130
|
-
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.
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
### Examples
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
(No example for this operation).
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
#### Using the get_affiliates_by_query_with_http_info variant
|
|
140
|
-
|
|
141
|
-
This returns an Array which contains the response data, status code and headers.
|
|
142
|
-
|
|
143
|
-
> <Array(<AffiliatesResponse>, Integer, Hash)> get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
144
|
-
|
|
145
|
-
```ruby
|
|
146
|
-
begin
|
|
147
|
-
# Retrieve affiliates
|
|
148
|
-
data, status_code, headers = api_instance.get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
149
|
-
p status_code # => 2xx
|
|
150
|
-
p headers # => { ... }
|
|
151
|
-
p data # => <AffiliatesResponse>
|
|
152
|
-
rescue UltracartClient::ApiError => e
|
|
153
|
-
puts "Error when calling AffiliateApi->get_affiliates_by_query_with_http_info: #{e}"
|
|
154
|
-
end
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
### Parameters
|
|
158
|
-
|
|
159
|
-
| Name | Type | Description | Notes |
|
|
160
|
-
| ---- | ---- | ----------- | ----- |
|
|
161
|
-
| **affiliate_query** | [**AffiliateQuery**](AffiliateQuery.md) | Affiliate query | |
|
|
162
|
-
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
163
|
-
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
164
|
-
| **_sort** | **String** | The sort order of the affiliates. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
|
|
165
|
-
|
|
166
|
-
### Return type
|
|
167
|
-
|
|
168
|
-
[**AffiliatesResponse**](AffiliatesResponse.md)
|
|
169
|
-
|
|
170
|
-
### Authorization
|
|
171
|
-
|
|
172
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
173
|
-
|
|
174
|
-
### HTTP request headers
|
|
175
|
-
|
|
176
|
-
- **Content-Type**: application/json
|
|
177
|
-
- **Accept**: application/json
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
## get_clicks_by_query
|
|
181
|
-
|
|
182
|
-
> <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
|
|
183
|
-
|
|
184
|
-
Retrieve clicks
|
|
185
|
-
|
|
186
|
-
Retrieves a group of clicks 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 clicks 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.
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
### Examples
|
|
190
|
-
|
|
191
|
-
```ruby
|
|
192
|
-
# Internal API. No samples are provided as merchants will never need this api method
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
#### Using the get_clicks_by_query_with_http_info variant
|
|
197
|
-
|
|
198
|
-
This returns an Array which contains the response data, status code and headers.
|
|
199
|
-
|
|
200
|
-
> <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
|
|
201
|
-
|
|
202
|
-
```ruby
|
|
203
|
-
begin
|
|
204
|
-
# Retrieve clicks
|
|
205
|
-
data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
|
|
206
|
-
p status_code # => 2xx
|
|
207
|
-
p headers # => { ... }
|
|
208
|
-
p data # => <AffiliateClicksResponse>
|
|
209
|
-
rescue UltracartClient::ApiError => e
|
|
210
|
-
puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
|
|
211
|
-
end
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
### Parameters
|
|
215
|
-
|
|
216
|
-
| Name | Type | Description | Notes |
|
|
217
|
-
| ---- | ---- | ----------- | ----- |
|
|
218
|
-
| **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
|
|
219
|
-
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
|
|
220
|
-
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
221
|
-
| **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
|
|
222
|
-
|
|
223
|
-
### Return type
|
|
224
|
-
|
|
225
|
-
[**AffiliateClicksResponse**](AffiliateClicksResponse.md)
|
|
226
|
-
|
|
227
|
-
### Authorization
|
|
228
|
-
|
|
229
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
230
|
-
|
|
231
|
-
### HTTP request headers
|
|
232
|
-
|
|
233
|
-
- **Content-Type**: application/json
|
|
234
|
-
- **Accept**: application/json
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
## get_ledgers_by_query
|
|
238
|
-
|
|
239
|
-
> <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
|
|
240
|
-
|
|
241
|
-
Retrieve ledger entries
|
|
242
|
-
|
|
243
|
-
Retrieves a group of ledger entries 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 ledgers 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.
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
### Examples
|
|
247
|
-
|
|
248
|
-
```ruby
|
|
249
|
-
# Internal API. No samples are provided as merchants will never need this api method
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
#### Using the get_ledgers_by_query_with_http_info variant
|
|
254
|
-
|
|
255
|
-
This returns an Array which contains the response data, status code and headers.
|
|
256
|
-
|
|
257
|
-
> <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
|
|
258
|
-
|
|
259
|
-
```ruby
|
|
260
|
-
begin
|
|
261
|
-
# Retrieve ledger entries
|
|
262
|
-
data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
|
|
263
|
-
p status_code # => 2xx
|
|
264
|
-
p headers # => { ... }
|
|
265
|
-
p data # => <AffiliateLedgersResponse>
|
|
266
|
-
rescue UltracartClient::ApiError => e
|
|
267
|
-
puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
|
|
268
|
-
end
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
### Parameters
|
|
272
|
-
|
|
273
|
-
| Name | Type | Description | Notes |
|
|
274
|
-
| ---- | ---- | ----------- | ----- |
|
|
275
|
-
| **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
|
|
276
|
-
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
277
|
-
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
278
|
-
| **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
|
|
279
|
-
|
|
280
|
-
### Return type
|
|
281
|
-
|
|
282
|
-
[**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
|
|
283
|
-
|
|
284
|
-
### Authorization
|
|
285
|
-
|
|
286
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
287
|
-
|
|
288
|
-
### HTTP request headers
|
|
289
|
-
|
|
290
|
-
- **Content-Type**: application/json
|
|
291
|
-
- **Accept**: application/json
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
## insert_affiliate
|
|
295
|
-
|
|
296
|
-
> <AffiliateResponse> insert_affiliate(affiliate, opts)
|
|
297
|
-
|
|
298
|
-
Insert an affiliate
|
|
299
|
-
|
|
300
|
-
Insert an affiliate on the UltraCart account. The affiliate is created within the merchant's active affiliate program.
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
### Examples
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
(No example for this operation).
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
#### Using the insert_affiliate_with_http_info variant
|
|
310
|
-
|
|
311
|
-
This returns an Array which contains the response data, status code and headers.
|
|
312
|
-
|
|
313
|
-
> <Array(<AffiliateResponse>, Integer, Hash)> insert_affiliate_with_http_info(affiliate, opts)
|
|
314
|
-
|
|
315
|
-
```ruby
|
|
316
|
-
begin
|
|
317
|
-
# Insert an affiliate
|
|
318
|
-
data, status_code, headers = api_instance.insert_affiliate_with_http_info(affiliate, opts)
|
|
319
|
-
p status_code # => 2xx
|
|
320
|
-
p headers # => { ... }
|
|
321
|
-
p data # => <AffiliateResponse>
|
|
322
|
-
rescue UltracartClient::ApiError => e
|
|
323
|
-
puts "Error when calling AffiliateApi->insert_affiliate_with_http_info: #{e}"
|
|
324
|
-
end
|
|
325
|
-
```
|
|
326
|
-
|
|
327
|
-
### Parameters
|
|
328
|
-
|
|
329
|
-
| Name | Type | Description | Notes |
|
|
330
|
-
| ---- | ---- | ----------- | ----- |
|
|
331
|
-
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to insert | |
|
|
332
|
-
| **send_welcome_email** | **Boolean** | Whether to send a welcome email to the affiliate after it is created. Defaults to false. | [optional][default to false] |
|
|
333
|
-
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
334
|
-
|
|
335
|
-
### Return type
|
|
336
|
-
|
|
337
|
-
[**AffiliateResponse**](AffiliateResponse.md)
|
|
338
|
-
|
|
339
|
-
### Authorization
|
|
340
|
-
|
|
341
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
342
|
-
|
|
343
|
-
### HTTP request headers
|
|
344
|
-
|
|
345
|
-
- **Content-Type**: application/json; charset=UTF-8
|
|
346
|
-
- **Accept**: application/json
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
## send_affiliate_welcome_email
|
|
350
|
-
|
|
351
|
-
> send_affiliate_welcome_email(affiliate_oid)
|
|
352
|
-
|
|
353
|
-
Send a welcome email to an affiliate
|
|
354
|
-
|
|
355
|
-
Sends a welcome email to the specified affiliate using the welcome letter configured on the merchant's active affiliate program.
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
### Examples
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
(No example for this operation).
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
#### Using the send_affiliate_welcome_email_with_http_info variant
|
|
365
|
-
|
|
366
|
-
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
367
|
-
|
|
368
|
-
> <Array(nil, Integer, Hash)> send_affiliate_welcome_email_with_http_info(affiliate_oid)
|
|
369
|
-
|
|
370
|
-
```ruby
|
|
371
|
-
begin
|
|
372
|
-
# Send a welcome email to an affiliate
|
|
373
|
-
data, status_code, headers = api_instance.send_affiliate_welcome_email_with_http_info(affiliate_oid)
|
|
374
|
-
p status_code # => 2xx
|
|
375
|
-
p headers # => { ... }
|
|
376
|
-
p data # => nil
|
|
377
|
-
rescue UltracartClient::ApiError => e
|
|
378
|
-
puts "Error when calling AffiliateApi->send_affiliate_welcome_email_with_http_info: #{e}"
|
|
379
|
-
end
|
|
380
|
-
```
|
|
381
|
-
|
|
382
|
-
### Parameters
|
|
383
|
-
|
|
384
|
-
| Name | Type | Description | Notes |
|
|
385
|
-
| ---- | ---- | ----------- | ----- |
|
|
386
|
-
| **affiliate_oid** | **Integer** | The affiliate oid to send the welcome email to. | |
|
|
387
|
-
|
|
388
|
-
### Return type
|
|
389
|
-
|
|
390
|
-
nil (empty response body)
|
|
391
|
-
|
|
392
|
-
### Authorization
|
|
393
|
-
|
|
394
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
395
|
-
|
|
396
|
-
### HTTP request headers
|
|
397
|
-
|
|
398
|
-
- **Content-Type**: Not defined
|
|
399
|
-
- **Accept**: application/json
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
## update_affiliate
|
|
403
|
-
|
|
404
|
-
> <AffiliateResponse> update_affiliate(affiliate_oid, affiliate, opts)
|
|
405
|
-
|
|
406
|
-
Update an affiliate
|
|
407
|
-
|
|
408
|
-
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.
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
### Examples
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
(No example for this operation).
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
#### Using the update_affiliate_with_http_info variant
|
|
418
|
-
|
|
419
|
-
This returns an Array which contains the response data, status code and headers.
|
|
420
|
-
|
|
421
|
-
> <Array(<AffiliateResponse>, Integer, Hash)> update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
422
|
-
|
|
423
|
-
```ruby
|
|
424
|
-
begin
|
|
425
|
-
# Update an affiliate
|
|
426
|
-
data, status_code, headers = api_instance.update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
427
|
-
p status_code # => 2xx
|
|
428
|
-
p headers # => { ... }
|
|
429
|
-
p data # => <AffiliateResponse>
|
|
430
|
-
rescue UltracartClient::ApiError => e
|
|
431
|
-
puts "Error when calling AffiliateApi->update_affiliate_with_http_info: #{e}"
|
|
432
|
-
end
|
|
433
|
-
```
|
|
434
|
-
|
|
435
|
-
### Parameters
|
|
436
|
-
|
|
437
|
-
| Name | Type | Description | Notes |
|
|
438
|
-
| ---- | ---- | ----------- | ----- |
|
|
439
|
-
| **affiliate_oid** | **Integer** | The affiliate oid to update. | |
|
|
440
|
-
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to update | |
|
|
441
|
-
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
442
|
-
|
|
443
|
-
### Return type
|
|
444
|
-
|
|
445
|
-
[**AffiliateResponse**](AffiliateResponse.md)
|
|
446
|
-
|
|
447
|
-
### Authorization
|
|
448
|
-
|
|
449
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
450
|
-
|
|
451
|
-
### HTTP request headers
|
|
452
|
-
|
|
453
|
-
- **Content-Type**: application/json; charset=UTF-8
|
|
454
|
-
- **Accept**: application/json
|
|
455
|
-
|
|
1
|
+
# UltracartClient::AffiliateApi
|
|
2
|
+
|
|
3
|
+
All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
4
|
+
|
|
5
|
+
| Method | HTTP request | Description |
|
|
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 |
|
|
10
|
+
| [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
|
|
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
|
+
| [**send_affiliate_welcome_email**](AffiliateApi.md#send_affiliate_welcome_email) | **POST** /affiliate/affiliates/{affiliate_oid}/welcome_email | Send a welcome email to an affiliate |
|
|
14
|
+
| [**update_affiliate**](AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate |
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
## delete_affiliate
|
|
18
|
+
|
|
19
|
+
> delete_affiliate(affiliate_oid)
|
|
20
|
+
|
|
21
|
+
Delete an affiliate
|
|
22
|
+
|
|
23
|
+
Delete an affiliate on the UltraCart account. The affiliate is disabled within the active affiliate program; their ledger and click history is preserved.
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
### Examples
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
(No example for this operation).
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
#### Using the delete_affiliate_with_http_info variant
|
|
33
|
+
|
|
34
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
35
|
+
|
|
36
|
+
> <Array(nil, Integer, Hash)> delete_affiliate_with_http_info(affiliate_oid)
|
|
37
|
+
|
|
38
|
+
```ruby
|
|
39
|
+
begin
|
|
40
|
+
# Delete an affiliate
|
|
41
|
+
data, status_code, headers = api_instance.delete_affiliate_with_http_info(affiliate_oid)
|
|
42
|
+
p status_code # => 2xx
|
|
43
|
+
p headers # => { ... }
|
|
44
|
+
p data # => nil
|
|
45
|
+
rescue UltracartClient::ApiError => e
|
|
46
|
+
puts "Error when calling AffiliateApi->delete_affiliate_with_http_info: #{e}"
|
|
47
|
+
end
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Parameters
|
|
51
|
+
|
|
52
|
+
| Name | Type | Description | Notes |
|
|
53
|
+
| ---- | ---- | ----------- | ----- |
|
|
54
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to delete. | |
|
|
55
|
+
|
|
56
|
+
### Return type
|
|
57
|
+
|
|
58
|
+
nil (empty response body)
|
|
59
|
+
|
|
60
|
+
### Authorization
|
|
61
|
+
|
|
62
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
63
|
+
|
|
64
|
+
### HTTP request headers
|
|
65
|
+
|
|
66
|
+
- **Content-Type**: Not defined
|
|
67
|
+
- **Accept**: application/json
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
## get_affiliate
|
|
71
|
+
|
|
72
|
+
> <AffiliateResponse> get_affiliate(affiliate_oid, opts)
|
|
73
|
+
|
|
74
|
+
Retrieve an affiliate
|
|
75
|
+
|
|
76
|
+
Retrieves a single affiliate using the specified affiliate oid.
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
### Examples
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
(No example for this operation).
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
#### Using the get_affiliate_with_http_info variant
|
|
86
|
+
|
|
87
|
+
This returns an Array which contains the response data, status code and headers.
|
|
88
|
+
|
|
89
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> get_affiliate_with_http_info(affiliate_oid, opts)
|
|
90
|
+
|
|
91
|
+
```ruby
|
|
92
|
+
begin
|
|
93
|
+
# Retrieve an affiliate
|
|
94
|
+
data, status_code, headers = api_instance.get_affiliate_with_http_info(affiliate_oid, opts)
|
|
95
|
+
p status_code # => 2xx
|
|
96
|
+
p headers # => { ... }
|
|
97
|
+
p data # => <AffiliateResponse>
|
|
98
|
+
rescue UltracartClient::ApiError => e
|
|
99
|
+
puts "Error when calling AffiliateApi->get_affiliate_with_http_info: #{e}"
|
|
100
|
+
end
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Parameters
|
|
104
|
+
|
|
105
|
+
| Name | Type | Description | Notes |
|
|
106
|
+
| ---- | ---- | ----------- | ----- |
|
|
107
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to retrieve. | |
|
|
108
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
109
|
+
|
|
110
|
+
### Return type
|
|
111
|
+
|
|
112
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
113
|
+
|
|
114
|
+
### Authorization
|
|
115
|
+
|
|
116
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
117
|
+
|
|
118
|
+
### HTTP request headers
|
|
119
|
+
|
|
120
|
+
- **Content-Type**: Not defined
|
|
121
|
+
- **Accept**: application/json
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
## get_affiliates_by_query
|
|
125
|
+
|
|
126
|
+
> <AffiliatesResponse> get_affiliates_by_query(affiliate_query, opts)
|
|
127
|
+
|
|
128
|
+
Retrieve affiliates
|
|
129
|
+
|
|
130
|
+
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.
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
### Examples
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
(No example for this operation).
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
#### Using the get_affiliates_by_query_with_http_info variant
|
|
140
|
+
|
|
141
|
+
This returns an Array which contains the response data, status code and headers.
|
|
142
|
+
|
|
143
|
+
> <Array(<AffiliatesResponse>, Integer, Hash)> get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
144
|
+
|
|
145
|
+
```ruby
|
|
146
|
+
begin
|
|
147
|
+
# Retrieve affiliates
|
|
148
|
+
data, status_code, headers = api_instance.get_affiliates_by_query_with_http_info(affiliate_query, opts)
|
|
149
|
+
p status_code # => 2xx
|
|
150
|
+
p headers # => { ... }
|
|
151
|
+
p data # => <AffiliatesResponse>
|
|
152
|
+
rescue UltracartClient::ApiError => e
|
|
153
|
+
puts "Error when calling AffiliateApi->get_affiliates_by_query_with_http_info: #{e}"
|
|
154
|
+
end
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Parameters
|
|
158
|
+
|
|
159
|
+
| Name | Type | Description | Notes |
|
|
160
|
+
| ---- | ---- | ----------- | ----- |
|
|
161
|
+
| **affiliate_query** | [**AffiliateQuery**](AffiliateQuery.md) | Affiliate query | |
|
|
162
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
163
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
164
|
+
| **_sort** | **String** | The sort order of the affiliates. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
|
|
165
|
+
|
|
166
|
+
### Return type
|
|
167
|
+
|
|
168
|
+
[**AffiliatesResponse**](AffiliatesResponse.md)
|
|
169
|
+
|
|
170
|
+
### Authorization
|
|
171
|
+
|
|
172
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
173
|
+
|
|
174
|
+
### HTTP request headers
|
|
175
|
+
|
|
176
|
+
- **Content-Type**: application/json
|
|
177
|
+
- **Accept**: application/json
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
## get_clicks_by_query
|
|
181
|
+
|
|
182
|
+
> <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
|
|
183
|
+
|
|
184
|
+
Retrieve clicks
|
|
185
|
+
|
|
186
|
+
Retrieves a group of clicks 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 clicks 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.
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
### Examples
|
|
190
|
+
|
|
191
|
+
```ruby
|
|
192
|
+
# Internal API. No samples are provided as merchants will never need this api method
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
|
|
196
|
+
#### Using the get_clicks_by_query_with_http_info variant
|
|
197
|
+
|
|
198
|
+
This returns an Array which contains the response data, status code and headers.
|
|
199
|
+
|
|
200
|
+
> <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
|
|
201
|
+
|
|
202
|
+
```ruby
|
|
203
|
+
begin
|
|
204
|
+
# Retrieve clicks
|
|
205
|
+
data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
|
|
206
|
+
p status_code # => 2xx
|
|
207
|
+
p headers # => { ... }
|
|
208
|
+
p data # => <AffiliateClicksResponse>
|
|
209
|
+
rescue UltracartClient::ApiError => e
|
|
210
|
+
puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
|
|
211
|
+
end
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
### Parameters
|
|
215
|
+
|
|
216
|
+
| Name | Type | Description | Notes |
|
|
217
|
+
| ---- | ---- | ----------- | ----- |
|
|
218
|
+
| **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
|
|
219
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
|
|
220
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
221
|
+
| **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
|
|
222
|
+
|
|
223
|
+
### Return type
|
|
224
|
+
|
|
225
|
+
[**AffiliateClicksResponse**](AffiliateClicksResponse.md)
|
|
226
|
+
|
|
227
|
+
### Authorization
|
|
228
|
+
|
|
229
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
230
|
+
|
|
231
|
+
### HTTP request headers
|
|
232
|
+
|
|
233
|
+
- **Content-Type**: application/json
|
|
234
|
+
- **Accept**: application/json
|
|
235
|
+
|
|
236
|
+
|
|
237
|
+
## get_ledgers_by_query
|
|
238
|
+
|
|
239
|
+
> <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
|
|
240
|
+
|
|
241
|
+
Retrieve ledger entries
|
|
242
|
+
|
|
243
|
+
Retrieves a group of ledger entries 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 ledgers 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.
|
|
244
|
+
|
|
245
|
+
|
|
246
|
+
### Examples
|
|
247
|
+
|
|
248
|
+
```ruby
|
|
249
|
+
# Internal API. No samples are provided as merchants will never need this api method
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
|
|
253
|
+
#### Using the get_ledgers_by_query_with_http_info variant
|
|
254
|
+
|
|
255
|
+
This returns an Array which contains the response data, status code and headers.
|
|
256
|
+
|
|
257
|
+
> <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
|
|
258
|
+
|
|
259
|
+
```ruby
|
|
260
|
+
begin
|
|
261
|
+
# Retrieve ledger entries
|
|
262
|
+
data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
|
|
263
|
+
p status_code # => 2xx
|
|
264
|
+
p headers # => { ... }
|
|
265
|
+
p data # => <AffiliateLedgersResponse>
|
|
266
|
+
rescue UltracartClient::ApiError => e
|
|
267
|
+
puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
|
|
268
|
+
end
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
### Parameters
|
|
272
|
+
|
|
273
|
+
| Name | Type | Description | Notes |
|
|
274
|
+
| ---- | ---- | ----------- | ----- |
|
|
275
|
+
| **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
|
|
276
|
+
| **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
|
|
277
|
+
| **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
|
|
278
|
+
| **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
|
|
279
|
+
|
|
280
|
+
### Return type
|
|
281
|
+
|
|
282
|
+
[**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
|
|
283
|
+
|
|
284
|
+
### Authorization
|
|
285
|
+
|
|
286
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
287
|
+
|
|
288
|
+
### HTTP request headers
|
|
289
|
+
|
|
290
|
+
- **Content-Type**: application/json
|
|
291
|
+
- **Accept**: application/json
|
|
292
|
+
|
|
293
|
+
|
|
294
|
+
## insert_affiliate
|
|
295
|
+
|
|
296
|
+
> <AffiliateResponse> insert_affiliate(affiliate, opts)
|
|
297
|
+
|
|
298
|
+
Insert an affiliate
|
|
299
|
+
|
|
300
|
+
Insert an affiliate on the UltraCart account. The affiliate is created within the merchant's active affiliate program.
|
|
301
|
+
|
|
302
|
+
|
|
303
|
+
### Examples
|
|
304
|
+
|
|
305
|
+
|
|
306
|
+
(No example for this operation).
|
|
307
|
+
|
|
308
|
+
|
|
309
|
+
#### Using the insert_affiliate_with_http_info variant
|
|
310
|
+
|
|
311
|
+
This returns an Array which contains the response data, status code and headers.
|
|
312
|
+
|
|
313
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> insert_affiliate_with_http_info(affiliate, opts)
|
|
314
|
+
|
|
315
|
+
```ruby
|
|
316
|
+
begin
|
|
317
|
+
# Insert an affiliate
|
|
318
|
+
data, status_code, headers = api_instance.insert_affiliate_with_http_info(affiliate, opts)
|
|
319
|
+
p status_code # => 2xx
|
|
320
|
+
p headers # => { ... }
|
|
321
|
+
p data # => <AffiliateResponse>
|
|
322
|
+
rescue UltracartClient::ApiError => e
|
|
323
|
+
puts "Error when calling AffiliateApi->insert_affiliate_with_http_info: #{e}"
|
|
324
|
+
end
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
### Parameters
|
|
328
|
+
|
|
329
|
+
| Name | Type | Description | Notes |
|
|
330
|
+
| ---- | ---- | ----------- | ----- |
|
|
331
|
+
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to insert | |
|
|
332
|
+
| **send_welcome_email** | **Boolean** | Whether to send a welcome email to the affiliate after it is created. Defaults to false. | [optional][default to false] |
|
|
333
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
334
|
+
|
|
335
|
+
### Return type
|
|
336
|
+
|
|
337
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
338
|
+
|
|
339
|
+
### Authorization
|
|
340
|
+
|
|
341
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
342
|
+
|
|
343
|
+
### HTTP request headers
|
|
344
|
+
|
|
345
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
346
|
+
- **Accept**: application/json
|
|
347
|
+
|
|
348
|
+
|
|
349
|
+
## send_affiliate_welcome_email
|
|
350
|
+
|
|
351
|
+
> send_affiliate_welcome_email(affiliate_oid)
|
|
352
|
+
|
|
353
|
+
Send a welcome email to an affiliate
|
|
354
|
+
|
|
355
|
+
Sends a welcome email to the specified affiliate using the welcome letter configured on the merchant's active affiliate program.
|
|
356
|
+
|
|
357
|
+
|
|
358
|
+
### Examples
|
|
359
|
+
|
|
360
|
+
|
|
361
|
+
(No example for this operation).
|
|
362
|
+
|
|
363
|
+
|
|
364
|
+
#### Using the send_affiliate_welcome_email_with_http_info variant
|
|
365
|
+
|
|
366
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
367
|
+
|
|
368
|
+
> <Array(nil, Integer, Hash)> send_affiliate_welcome_email_with_http_info(affiliate_oid)
|
|
369
|
+
|
|
370
|
+
```ruby
|
|
371
|
+
begin
|
|
372
|
+
# Send a welcome email to an affiliate
|
|
373
|
+
data, status_code, headers = api_instance.send_affiliate_welcome_email_with_http_info(affiliate_oid)
|
|
374
|
+
p status_code # => 2xx
|
|
375
|
+
p headers # => { ... }
|
|
376
|
+
p data # => nil
|
|
377
|
+
rescue UltracartClient::ApiError => e
|
|
378
|
+
puts "Error when calling AffiliateApi->send_affiliate_welcome_email_with_http_info: #{e}"
|
|
379
|
+
end
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
### Parameters
|
|
383
|
+
|
|
384
|
+
| Name | Type | Description | Notes |
|
|
385
|
+
| ---- | ---- | ----------- | ----- |
|
|
386
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to send the welcome email to. | |
|
|
387
|
+
|
|
388
|
+
### Return type
|
|
389
|
+
|
|
390
|
+
nil (empty response body)
|
|
391
|
+
|
|
392
|
+
### Authorization
|
|
393
|
+
|
|
394
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
395
|
+
|
|
396
|
+
### HTTP request headers
|
|
397
|
+
|
|
398
|
+
- **Content-Type**: Not defined
|
|
399
|
+
- **Accept**: application/json
|
|
400
|
+
|
|
401
|
+
|
|
402
|
+
## update_affiliate
|
|
403
|
+
|
|
404
|
+
> <AffiliateResponse> update_affiliate(affiliate_oid, affiliate, opts)
|
|
405
|
+
|
|
406
|
+
Update an affiliate
|
|
407
|
+
|
|
408
|
+
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.
|
|
409
|
+
|
|
410
|
+
|
|
411
|
+
### Examples
|
|
412
|
+
|
|
413
|
+
|
|
414
|
+
(No example for this operation).
|
|
415
|
+
|
|
416
|
+
|
|
417
|
+
#### Using the update_affiliate_with_http_info variant
|
|
418
|
+
|
|
419
|
+
This returns an Array which contains the response data, status code and headers.
|
|
420
|
+
|
|
421
|
+
> <Array(<AffiliateResponse>, Integer, Hash)> update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
422
|
+
|
|
423
|
+
```ruby
|
|
424
|
+
begin
|
|
425
|
+
# Update an affiliate
|
|
426
|
+
data, status_code, headers = api_instance.update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
|
|
427
|
+
p status_code # => 2xx
|
|
428
|
+
p headers # => { ... }
|
|
429
|
+
p data # => <AffiliateResponse>
|
|
430
|
+
rescue UltracartClient::ApiError => e
|
|
431
|
+
puts "Error when calling AffiliateApi->update_affiliate_with_http_info: #{e}"
|
|
432
|
+
end
|
|
433
|
+
```
|
|
434
|
+
|
|
435
|
+
### Parameters
|
|
436
|
+
|
|
437
|
+
| Name | Type | Description | Notes |
|
|
438
|
+
| ---- | ---- | ----------- | ----- |
|
|
439
|
+
| **affiliate_oid** | **Integer** | The affiliate oid to update. | |
|
|
440
|
+
| **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to update | |
|
|
441
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
442
|
+
|
|
443
|
+
### Return type
|
|
444
|
+
|
|
445
|
+
[**AffiliateResponse**](AffiliateResponse.md)
|
|
446
|
+
|
|
447
|
+
### Authorization
|
|
448
|
+
|
|
449
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
450
|
+
|
|
451
|
+
### HTTP request headers
|
|
452
|
+
|
|
453
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
454
|
+
- **Accept**: application/json
|
|
455
|
+
|