Version: 1.0.0

Java SDK

The Java Server SDK (com.candescent.forge:di-java-sdk) is a Java client for the Candescent Digital Insight API.

What the Java SDK does

com.candescent.forge:di-java-sdk lets you call the DI API from Java with a single typed client instead of hand-written HTTP requests.

• Wraps every DI API operation — accounts, customers, authentication, business banking, money movement, alerts, and more through CandescentClient service-area accessors
• Handles OAuth for you — obtains, caches, and refreshes tokens; injects Authorization headers on each request
• Stays type-safe — typed request and response models generated from the DI API
• Manages API complexity — V1/V2 OAuth routing, XML token responses, pagination, retries, and typed exceptions are built in

Use it in integration services, backend-for-frontend (BFF) services, batch jobs, Spring Boot applications, and other server-side Java applications that connect to the DI API.

Choose the Java SDK when you need:

Capability	Description
CandescentClient	One typed entry point for all DI API service areas
Automatic OAuth	Client-credentials flow with token cache and refresh (no manual Authorization headers)
Typed models	Request and response types generated from OpenAPI
PageIterator	Synchronous iteration across paginated list endpoints
Typed exceptions	Map generated ApiException to SDK exception hierarchy via CandescentClient.mapException()
Built-in retries	Exponential backoff on transient 408, 429, and 5xx responses
Standalone operations	Per-operation helpers in com.candescent.di.operations for serverless and scripts

Next steps

1. Installation — add the Maven dependency and run your first API call
2. Quick Start — authentication, accounts, business banking, and standalone operations
3. SDK Reference — full client API, service areas, and packages
4. Examples — runnable examples for every API area