Adaptor Implementation

Two ways to build a PDX channel adapter: the Adapter SDK or the Adapter Gateway REST API.

A channel adapter is the component that receives submitted product data from PDX and delivers it to the target system. All adapters integrate with PDX through the Adapter Gateway over HTTPS; there are two supported ways to build one:

  1. Adapter SDK — a Java/Spring Boot library (com.stibo.leap:adapter-sdk). The SDK is a client of the Adapter Gateway that manages the integration for you: it polls for events, dispatches them to handler beans you implement (authentication, submission, deletion), and provides typed object models for products and datastandards.
  2. Adapter Gateway REST API — the same HTTP API (/external/*), called directly. Your adapter can be written in any language; you implement the event polling, data fetching, and status reporting yourself.

Both paths produce a fully functional channel: the channel and its datastandard are registered the same way, the same events are available, and PDX users see no difference.

Which one should I choose?

Adapter SDKAdapter Gateway REST API
Language / frameworkJava + Spring BootAny language
Programming modelImplement handler beans; the SDK polls for events, dispatches to your handlers, and provides typed modelsCall the REST endpoints directly; you write the polling loop and data handling yourself
Dependenciesadapter-sdk from the PDX Maven repository (credentials provided during onboarding)None
📘

Rule of thumb

If you are building on Java/Spring and want event handling and object models managed for you, use the Adapter SDK. If you are building in another language, or want full control over the integration, use the Adapter Gateway REST API directly.

Where to go next


Did this page help you?