ultracart_api 4.1.12 → 4.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/docs/SsoApi.md CHANGED
@@ -1,288 +1,223 @@
1
- # UltracartClient::SsoApi
2
-
3
- All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
-
5
- | Method | HTTP request | Description |
6
- | ------ | ------------ | ----------- |
7
- | [**get_sso_session_user**](SsoApi.md#get_sso_session_user) | **GET** /sso/session/user | Get single sign on session user |
8
- | [**sso_authorize**](SsoApi.md#sso_authorize) | **PUT** /sso/authorize | Authorize a single sign on session |
9
- | [**sso_session_revoke**](SsoApi.md#sso_session_revoke) | **DELETE** /sso/session/revoke | Revoke single sign on session |
10
- | [**sso_token**](SsoApi.md#sso_token) | **PUT** /sso/token | Exchange a single sign on code for a simple key token |
11
-
12
-
13
- ## get_sso_session_user
14
-
15
- > <User> get_sso_session_user
16
-
17
- Get single sign on session user
18
-
19
- This is the equivalent of logging out of the single sign on session
20
-
21
- ### Examples
22
-
23
- ```ruby
24
- require 'time'
25
- require 'ultracart_api'
26
- require 'json'
27
- require 'yaml'
28
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
29
-
30
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
31
- # As such, this might not be the best way to use this object.
32
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
33
-
34
- api = UltracartClient::SsoApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
35
-
36
- begin
37
- # Get single sign on session user
38
- result = api_instance.get_sso_session_user
39
- p result
40
- rescue UltracartClient::ApiError => e
41
- puts "Error when calling SsoApi->get_sso_session_user: #{e}"
42
- end
43
- ```
44
-
45
- #### Using the get_sso_session_user_with_http_info variant
46
-
47
- This returns an Array which contains the response data, status code and headers.
48
-
49
- > <Array(<User>, Integer, Hash)> get_sso_session_user_with_http_info
50
-
51
- ```ruby
52
- begin
53
- # Get single sign on session user
54
- data, status_code, headers = api_instance.get_sso_session_user_with_http_info
55
- p status_code # => 2xx
56
- p headers # => { ... }
57
- p data # => <User>
58
- rescue UltracartClient::ApiError => e
59
- puts "Error when calling SsoApi->get_sso_session_user_with_http_info: #{e}"
60
- end
61
- ```
62
-
63
- ### Parameters
64
-
65
- This endpoint does not need any parameter.
66
-
67
- ### Return type
68
-
69
- [**User**](User.md)
70
-
71
- ### Authorization
72
-
73
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
74
-
75
- ### HTTP request headers
76
-
77
- - **Content-Type**: Not defined
78
- - **Accept**: application/json
79
-
80
-
81
- ## sso_authorize
82
-
83
- > <SingleSignOnAuthorizeResponse> sso_authorize(authorization_request)
84
-
85
- Authorize a single sign on session
86
-
87
- Starts the process of authorizing a single sign on session.
88
-
89
- ### Examples
90
-
91
- ```ruby
92
- require 'time'
93
- require 'ultracart_api'
94
- require 'json'
95
- require 'yaml'
96
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
97
-
98
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
99
- # As such, this might not be the best way to use this object.
100
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
101
-
102
- api = UltracartClient::SsoApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
103
- authorization_request = UltracartClient::SingleSignOnAuthorizeRequest.new # SingleSignOnAuthorizeRequest | Authorization request
104
-
105
- begin
106
- # Authorize a single sign on session
107
- result = api_instance.sso_authorize(authorization_request)
108
- p result
109
- rescue UltracartClient::ApiError => e
110
- puts "Error when calling SsoApi->sso_authorize: #{e}"
111
- end
112
- ```
113
-
114
- #### Using the sso_authorize_with_http_info variant
115
-
116
- This returns an Array which contains the response data, status code and headers.
117
-
118
- > <Array(<SingleSignOnAuthorizeResponse>, Integer, Hash)> sso_authorize_with_http_info(authorization_request)
119
-
120
- ```ruby
121
- begin
122
- # Authorize a single sign on session
123
- data, status_code, headers = api_instance.sso_authorize_with_http_info(authorization_request)
124
- p status_code # => 2xx
125
- p headers # => { ... }
126
- p data # => <SingleSignOnAuthorizeResponse>
127
- rescue UltracartClient::ApiError => e
128
- puts "Error when calling SsoApi->sso_authorize_with_http_info: #{e}"
129
- end
130
- ```
131
-
132
- ### Parameters
133
-
134
- | Name | Type | Description | Notes |
135
- | ---- | ---- | ----------- | ----- |
136
- | **authorization_request** | [**SingleSignOnAuthorizeRequest**](SingleSignOnAuthorizeRequest.md) | Authorization request | |
137
-
138
- ### Return type
139
-
140
- [**SingleSignOnAuthorizeResponse**](SingleSignOnAuthorizeResponse.md)
141
-
142
- ### Authorization
143
-
144
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
145
-
146
- ### HTTP request headers
147
-
148
- - **Content-Type**: application/json; charset=UTF-8
149
- - **Accept**: application/json
150
-
151
-
152
- ## sso_session_revoke
153
-
154
- > sso_session_revoke
155
-
156
- Revoke single sign on session
157
-
158
- This is the equivalent of logging out of the single sign on session
159
-
160
- ### Examples
161
-
162
- ```ruby
163
- require 'time'
164
- require 'ultracart_api'
165
- require 'json'
166
- require 'yaml'
167
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
168
-
169
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
170
- # As such, this might not be the best way to use this object.
171
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
172
-
173
- api = UltracartClient::SsoApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
174
-
175
- begin
176
- # Revoke single sign on session
177
- api_instance.sso_session_revoke
178
- rescue UltracartClient::ApiError => e
179
- puts "Error when calling SsoApi->sso_session_revoke: #{e}"
180
- end
181
- ```
182
-
183
- #### Using the sso_session_revoke_with_http_info variant
184
-
185
- This returns an Array which contains the response data (`nil` in this case), status code and headers.
186
-
187
- > <Array(nil, Integer, Hash)> sso_session_revoke_with_http_info
188
-
189
- ```ruby
190
- begin
191
- # Revoke single sign on session
192
- data, status_code, headers = api_instance.sso_session_revoke_with_http_info
193
- p status_code # => 2xx
194
- p headers # => { ... }
195
- p data # => nil
196
- rescue UltracartClient::ApiError => e
197
- puts "Error when calling SsoApi->sso_session_revoke_with_http_info: #{e}"
198
- end
199
- ```
200
-
201
- ### Parameters
202
-
203
- This endpoint does not need any parameter.
204
-
205
- ### Return type
206
-
207
- nil (empty response body)
208
-
209
- ### Authorization
210
-
211
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
212
-
213
- ### HTTP request headers
214
-
215
- - **Content-Type**: Not defined
216
- - **Accept**: application/json
217
-
218
-
219
- ## sso_token
220
-
221
- > <SingleSignOnTokenResponse> sso_token(token_request)
222
-
223
- Exchange a single sign on code for a simple key token
224
-
225
- Called by your application after receiving the code back on the redirect URI to obtain a simple key token to make API calls with
226
-
227
- ### Examples
228
-
229
- ```ruby
230
- require 'time'
231
- require 'ultracart_api'
232
- require 'json'
233
- require 'yaml'
234
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
235
-
236
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
237
- # As such, this might not be the best way to use this object.
238
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
239
-
240
- api = UltracartClient::SsoApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
241
- token_request = UltracartClient::SingleSignOnTokenRequest.new # SingleSignOnTokenRequest | Token request
242
-
243
- begin
244
- # Exchange a single sign on code for a simple key token
245
- result = api_instance.sso_token(token_request)
246
- p result
247
- rescue UltracartClient::ApiError => e
248
- puts "Error when calling SsoApi->sso_token: #{e}"
249
- end
250
- ```
251
-
252
- #### Using the sso_token_with_http_info variant
253
-
254
- This returns an Array which contains the response data, status code and headers.
255
-
256
- > <Array(<SingleSignOnTokenResponse>, Integer, Hash)> sso_token_with_http_info(token_request)
257
-
258
- ```ruby
259
- begin
260
- # Exchange a single sign on code for a simple key token
261
- data, status_code, headers = api_instance.sso_token_with_http_info(token_request)
262
- p status_code # => 2xx
263
- p headers # => { ... }
264
- p data # => <SingleSignOnTokenResponse>
265
- rescue UltracartClient::ApiError => e
266
- puts "Error when calling SsoApi->sso_token_with_http_info: #{e}"
267
- end
268
- ```
269
-
270
- ### Parameters
271
-
272
- | Name | Type | Description | Notes |
273
- | ---- | ---- | ----------- | ----- |
274
- | **token_request** | [**SingleSignOnTokenRequest**](SingleSignOnTokenRequest.md) | Token request | |
275
-
276
- ### Return type
277
-
278
- [**SingleSignOnTokenResponse**](SingleSignOnTokenResponse.md)
279
-
280
- ### Authorization
281
-
282
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
283
-
284
- ### HTTP request headers
285
-
286
- - **Content-Type**: application/json; charset=UTF-8
287
- - **Accept**: application/json
288
-
1
+ # UltracartClient::SsoApi
2
+
3
+ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**get_sso_session_user**](SsoApi.md#get_sso_session_user) | **GET** /sso/session/user | Get single sign on session user |
8
+ | [**sso_authorize**](SsoApi.md#sso_authorize) | **PUT** /sso/authorize | Authorize a single sign on session |
9
+ | [**sso_session_revoke**](SsoApi.md#sso_session_revoke) | **DELETE** /sso/session/revoke | Revoke single sign on session |
10
+ | [**sso_token**](SsoApi.md#sso_token) | **PUT** /sso/token | Exchange a single sign on code for a simple key token |
11
+
12
+
13
+ ## get_sso_session_user
14
+
15
+ > <User> get_sso_session_user
16
+
17
+ Get single sign on session user
18
+
19
+ This is the equivalent of logging out of the single sign on session
20
+
21
+
22
+ ### Examples
23
+
24
+ ```ruby
25
+ # Internal API. No samples are provided as merchants will never need this api method
26
+ ```
27
+
28
+
29
+ #### Using the get_sso_session_user_with_http_info variant
30
+
31
+ This returns an Array which contains the response data, status code and headers.
32
+
33
+ > <Array(<User>, Integer, Hash)> get_sso_session_user_with_http_info
34
+
35
+ ```ruby
36
+ begin
37
+ # Get single sign on session user
38
+ data, status_code, headers = api_instance.get_sso_session_user_with_http_info
39
+ p status_code # => 2xx
40
+ p headers # => { ... }
41
+ p data # => <User>
42
+ rescue UltracartClient::ApiError => e
43
+ puts "Error when calling SsoApi->get_sso_session_user_with_http_info: #{e}"
44
+ end
45
+ ```
46
+
47
+ ### Parameters
48
+
49
+ This endpoint does not need any parameter.
50
+
51
+ ### Return type
52
+
53
+ [**User**](User.md)
54
+
55
+ ### Authorization
56
+
57
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
58
+
59
+ ### HTTP request headers
60
+
61
+ - **Content-Type**: Not defined
62
+ - **Accept**: application/json
63
+
64
+
65
+ ## sso_authorize
66
+
67
+ > <SingleSignOnAuthorizeResponse> sso_authorize(authorization_request)
68
+
69
+ Authorize a single sign on session
70
+
71
+ Starts the process of authorizing a single sign on session.
72
+
73
+
74
+ ### Examples
75
+
76
+ ```ruby
77
+ # Internal API. No samples are provided as merchants will never need this api method
78
+ ```
79
+
80
+
81
+ #### Using the sso_authorize_with_http_info variant
82
+
83
+ This returns an Array which contains the response data, status code and headers.
84
+
85
+ > <Array(<SingleSignOnAuthorizeResponse>, Integer, Hash)> sso_authorize_with_http_info(authorization_request)
86
+
87
+ ```ruby
88
+ begin
89
+ # Authorize a single sign on session
90
+ data, status_code, headers = api_instance.sso_authorize_with_http_info(authorization_request)
91
+ p status_code # => 2xx
92
+ p headers # => { ... }
93
+ p data # => <SingleSignOnAuthorizeResponse>
94
+ rescue UltracartClient::ApiError => e
95
+ puts "Error when calling SsoApi->sso_authorize_with_http_info: #{e}"
96
+ end
97
+ ```
98
+
99
+ ### Parameters
100
+
101
+ | Name | Type | Description | Notes |
102
+ | ---- | ---- | ----------- | ----- |
103
+ | **authorization_request** | [**SingleSignOnAuthorizeRequest**](SingleSignOnAuthorizeRequest.md) | Authorization request | |
104
+
105
+ ### Return type
106
+
107
+ [**SingleSignOnAuthorizeResponse**](SingleSignOnAuthorizeResponse.md)
108
+
109
+ ### Authorization
110
+
111
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
112
+
113
+ ### HTTP request headers
114
+
115
+ - **Content-Type**: application/json; charset=UTF-8
116
+ - **Accept**: application/json
117
+
118
+
119
+ ## sso_session_revoke
120
+
121
+ > sso_session_revoke
122
+
123
+ Revoke single sign on session
124
+
125
+ This is the equivalent of logging out of the single sign on session
126
+
127
+
128
+ ### Examples
129
+
130
+ ```ruby
131
+ # Internal API. No samples are provided as merchants will never need this api method
132
+ ```
133
+
134
+
135
+ #### Using the sso_session_revoke_with_http_info variant
136
+
137
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
138
+
139
+ > <Array(nil, Integer, Hash)> sso_session_revoke_with_http_info
140
+
141
+ ```ruby
142
+ begin
143
+ # Revoke single sign on session
144
+ data, status_code, headers = api_instance.sso_session_revoke_with_http_info
145
+ p status_code # => 2xx
146
+ p headers # => { ... }
147
+ p data # => nil
148
+ rescue UltracartClient::ApiError => e
149
+ puts "Error when calling SsoApi->sso_session_revoke_with_http_info: #{e}"
150
+ end
151
+ ```
152
+
153
+ ### Parameters
154
+
155
+ This endpoint does not need any parameter.
156
+
157
+ ### Return type
158
+
159
+ nil (empty response body)
160
+
161
+ ### Authorization
162
+
163
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
164
+
165
+ ### HTTP request headers
166
+
167
+ - **Content-Type**: Not defined
168
+ - **Accept**: application/json
169
+
170
+
171
+ ## sso_token
172
+
173
+ > <SingleSignOnTokenResponse> sso_token(token_request)
174
+
175
+ Exchange a single sign on code for a simple key token
176
+
177
+ Called by your application after receiving the code back on the redirect URI to obtain a simple key token to make API calls with
178
+
179
+
180
+ ### Examples
181
+
182
+ ```ruby
183
+ # Internal API. No samples are provided as merchants will never need this api method
184
+ ```
185
+
186
+
187
+ #### Using the sso_token_with_http_info variant
188
+
189
+ This returns an Array which contains the response data, status code and headers.
190
+
191
+ > <Array(<SingleSignOnTokenResponse>, Integer, Hash)> sso_token_with_http_info(token_request)
192
+
193
+ ```ruby
194
+ begin
195
+ # Exchange a single sign on code for a simple key token
196
+ data, status_code, headers = api_instance.sso_token_with_http_info(token_request)
197
+ p status_code # => 2xx
198
+ p headers # => { ... }
199
+ p data # => <SingleSignOnTokenResponse>
200
+ rescue UltracartClient::ApiError => e
201
+ puts "Error when calling SsoApi->sso_token_with_http_info: #{e}"
202
+ end
203
+ ```
204
+
205
+ ### Parameters
206
+
207
+ | Name | Type | Description | Notes |
208
+ | ---- | ---- | ----------- | ----- |
209
+ | **token_request** | [**SingleSignOnTokenRequest**](SingleSignOnTokenRequest.md) | Token request | |
210
+
211
+ ### Return type
212
+
213
+ [**SingleSignOnTokenResponse**](SingleSignOnTokenResponse.md)
214
+
215
+ ### Authorization
216
+
217
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
218
+
219
+ ### HTTP request headers
220
+
221
+ - **Content-Type**: application/json; charset=UTF-8
222
+ - **Accept**: application/json
223
+