1111<!-- Start Summary [summary] -->
1212## Summary
1313
14- Accounting: The documentation for the StackOne Unified API - ACCOUNTING
14+ Accounting: The documentation for the StackOne API
15+ The documentation for the StackOne Unified API - HRIS
16+ The documentation for the StackOne Unified API - ATS
17+ The documentation for the StackOne Unified API - CRM
18+ The documentation for the StackOne Unified API - IAM
19+ The documentation for the StackOne Unified API - MARKETING
20+ The documentation for the StackOne Unified API - LMS
21+ The documentation for the StackOne Unified API - TICKETING
22+ The documentation for the StackOne Unified API - DOCUMENTS
23+ The documentation for the StackOne Unified API - SCREENING
24+ The documentation for the StackOne Unified API - MESSAGING
25+ The documentation for the StackOne Unified API - ACCOUNTING
1526<!-- End Summary [summary] -->
1627
1728<!-- Start Table of Contents [toc] -->
@@ -29,6 +40,7 @@ Accounting: The documentation for the StackOne Unified API - ACCOUNTING
2940 * [ Authentication] ( #authentication )
3041 * [ Custom HTTP Client] ( #custom-http-client )
3142 * [ Debugging] ( #debugging )
43+ * [ Jackson Configuration] ( #jackson-configuration )
3244* [ Development] ( #development )
3345 * [ Maturity] ( #maturity )
3446 * [ Contributions] ( #contributions )
@@ -46,15 +58,15 @@ The samples below show how a published SDK artifact is used:
4658
4759Gradle:
4860``` groovy
49- implementation 'com.stackone:stackone-client-java:0.19.2 '
61+ implementation 'com.stackone:stackone-client-java:0.19.3 '
5062```
5163
5264Maven:
5365``` xml
5466<dependency >
5567 <groupId >com.stackone</groupId >
5668 <artifactId >stackone-client-java</artifactId >
57- <version >0.19.2 </version >
69+ <version >0.19.3 </version >
5870</dependency >
5971```
6072
@@ -171,14 +183,23 @@ public class Application {
171183
172184 resFut. thenAccept(res - > {
173185 if (res. connectSessionTokenAuthLink(). isPresent()) {
174- // handle response
186+ System . out . println(res . connectSessionTokenAuthLink() . get());
175187 }
176188 });
177189 }
178190}
179191```
180192
181193[ comp-fut ] : https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
194+
195+ #### Union Consumption Patterns
196+
197+ When a response field is a union model:
198+
199+ - Discriminated unions: branch on the discriminator (` switch ` ) and then narrow to the concrete type.
200+ - Non-discriminated unions: use generated accessors (for example ` string() ` , ` asLong() ` , ` simpleObject() ` ) to determine the active variant.
201+
202+ For full model-specific examples (including Java 11/16/21 variants), see each union model's ** Supported Types** section in the generated model docs.
182203<!-- End SDK Example Usage [usage] -->
183204
184205<!-- Start Available Resources and Operations [operations] -->
@@ -206,7 +227,7 @@ public class Application {
206227* [ getAccount] ( docs/sdks/accounts/README.md#getaccount ) - Get Account
207228* [ deleteAccount] ( docs/sdks/accounts/README.md#deleteaccount ) - Delete Account
208229* [ updateAccount] ( docs/sdks/accounts/README.md#updateaccount ) - Update Account
209- * [ getAccountMetaInfo] ( docs/sdks/accounts/README.md#getaccountmetainfo ) - Get Account Meta Information
230+ * [ ~~ getAccountMetaInfo~~ ] ( docs/sdks/accounts/README.md#getaccountmetainfo ) - Get Account Meta Information (Legacy) : warning : ** Deprecated **
210231
211232### [ Actions] ( docs/sdks/actions/README.md )
212233
@@ -299,10 +320,10 @@ public class Application {
299320* [ createConnectSession] ( docs/sdks/connectsessions/README.md#createconnectsession ) - Create Connect Session
300321* [ authenticateConnectSession] ( docs/sdks/connectsessions/README.md#authenticateconnectsession ) - Authenticate Connect Session
301322
302- ### [ Connectors] ( docs/sdks/connectors/README.md )
323+ ### [ ~~ Connectors~~ ] ( docs/sdks/connectors/README.md )
303324
304- * [ listConnectorsMeta] ( docs/sdks/connectors/README.md#listconnectorsmeta ) - List Connector Meta Information
305- * [ getConnectorMeta] ( docs/sdks/connectors/README.md#getconnectormeta ) - Get Connector Meta Information
325+ * [ ~~ listConnectorsMeta~~ ] ( docs/sdks/connectors/README.md#listconnectorsmeta ) - List Connector Meta Information (Legacy) : warning : ** Deprecated **
326+ * [ ~~ getConnectorMeta~~ ] ( docs/sdks/connectors/README.md#getconnectormeta ) - Get Connector Meta Information (Legacy) : warning : ** Deprecated **
306327
307328### [ Crm] ( docs/sdks/crm/README.md )
308329
@@ -493,9 +514,9 @@ public class Application {
493514* [ getMessage] ( docs/sdks/messaging/README.md#getmessage ) - Get Message
494515* [ sendMessage] ( docs/sdks/messaging/README.md#sendmessage ) - Send Message
495516
496- ### [ Proxy] ( docs/sdks/proxy/README.md )
517+ ### [ ~~ Proxy~~ ] ( docs/sdks/proxy/README.md )
497518
498- * [ proxyRequest] ( docs/sdks/proxy/README.md#proxyrequest ) - Proxy Request
519+ * [ ~~ proxyRequest~~ ] ( docs/sdks/proxy/README.md#proxyrequest ) - Proxy Request (Legacy) : warning : ** Deprecated **
499520
500521### [ RequestLogs] ( docs/sdks/requestlogs/README.md )
501522
@@ -725,7 +746,7 @@ public class Application {
725746 .call();
726747
727748 if (res. connectSessionTokenAuthLink(). isPresent()) {
728- // handle response
749+ System . out . println(res . connectSessionTokenAuthLink() . get());
729750 }
730751 }
731752}
@@ -792,7 +813,7 @@ public class Application {
792813 .call();
793814
794815 if (res. connectSessionTokenAuthLink(). isPresent()) {
795- // handle response
816+ System . out . println(res . connectSessionTokenAuthLink() . get());
796817 }
797818 }
798819}
@@ -868,7 +889,7 @@ public class Application {
868889 .call();
869890
870891 if (res. connectSessionTokenAuthLink(). isPresent()) {
871- // handle response
892+ System . out . println(res . connectSessionTokenAuthLink() . get());
872893 }
873894 } catch (StackOneError ex) { // all SDK exceptions inherit from StackOneError
874895
@@ -994,7 +1015,7 @@ public class Application {
9941015 .call();
9951016
9961017 if (res. connectSessionTokenAuthLink(). isPresent()) {
997- // handle response
1018+ System . out . println(res . connectSessionTokenAuthLink() . get());
9981019 }
9991020 }
10001021}
@@ -1126,7 +1147,7 @@ public class Application {
11261147 .call();
11271148
11281149 if (res. connectSessionTokenAuthLink(). isPresent()) {
1129- // handle response
1150+ System . out . println(res . connectSessionTokenAuthLink() . get());
11301151 }
11311152 }
11321153}
@@ -1335,6 +1356,36 @@ __NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging
13351356Another option is to set the System property ` -Djdk.httpclient.HttpClient.log=all ` . However, this second option does not log bodies.
13361357<!-- End Debugging [debug] -->
13371358
1359+ <!-- Start Jackson Configuration [jackson] -->
1360+ ## Jackson Configuration
1361+
1362+ The SDK ships with a pre-configured Jackson [ ` ObjectMapper ` ] [ jackson-databind ] accessible via
1363+ ` JSON.getMapper() ` . It is set up with type modules, strict deserializers, and the feature flags
1364+ needed for full SDK compatibility (including ISO-8601 ` OffsetDateTime ` serialization):
1365+
1366+ ``` java
1367+ import com.stackone.stackone_client_java.utils.JSON ;
1368+
1369+ String json = JSON . getMapper(). writeValueAsString(response);
1370+ ```
1371+
1372+ To compose with your own ` ObjectMapper ` , register the provided ` StackoneClientJavaJacksonModule ` , which
1373+ bundles all the same modules and feature flags as a single plug-and-play module:
1374+
1375+ ``` java
1376+ import com.stackone.stackone_client_java.utils.StackoneClientJavaJacksonModule ;
1377+ import com.fasterxml.jackson.databind.ObjectMapper ;
1378+
1379+ ObjectMapper myMapper = new ObjectMapper ()
1380+ .registerModule(new StackoneClientJavaJacksonModule ());
1381+
1382+ String json = myMapper. writeValueAsString(response);
1383+ ```
1384+
1385+ [ jackson-databind ] : https://github.com/FasterXML/jackson-databind
1386+ [ jackson-jsr310 ] : https://github.com/FasterXML/jackson-modules-java8/tree/master/datetime
1387+ <!-- End Jackson Configuration [jackson] -->
1388+
13381389<!-- Placeholder for Future Speakeasy SDK Sections -->
13391390
13401391# Development
0 commit comments