Skip to content
ID4i API client example in Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


CircleCI Support Chat API Client Version

ID4i API Client Example - Java

ID4i provides globally unique IDs for single workpieces and a platform to manage, and exchange data bound to IDs in an inter-organizational manner. For details, please refer to

This repository contains all example Java API Client for ID4i. For detailed documentation of ID4i see


  • Java 1.8

  • Maven >= 3.5.0


To be able to connect to ID4i with an API client, you need to register and set up an API key for your application first. Using this key, you can sign JWTs to send as Authorization header for subsequent requests.

  1. If you do not already have an ID4i sandbox account, please register at and log in.

  2. Navigate to API Keys and select New API Key

    readme new api key
    Figure 1. New API Key
  3. Give your key a label and enter an application secret (or let the application generate one for you). [1]

    readme new api key 2
    Figure 2. API Key Label and Secret
  4. Save your secret resp. your public key in a secure location. For security reasons, you won’t be able to display this key again in ID4i.

  5. Activate the key on the details page

    readme new api key 3
    Figure 3. API Key Activation
Do not store your API Keys and Secrets with the source code of your application. Either supply the key as a configuration property of your application or retrieve it from your own server when required in the application. Use a separate API Key for each deployment of your application.

For some tutorials, you will need also additional GUID collections, more than one API key and further organizations. These can be either created programmatically using the API or via the user interface as shown below.

To create the labelled collection called Product Batch, use Menu → Collections → New Collection (Product Batch, Labelled Collection).

create labellled collection
Figure 4. New Collection

To create an organization: Menu → Organizations → New Organization (Reseller).

create organization
Figure 5. New Organization

Now clone this repository and you are good to go.

Please note that with the default settings, you will connect to the ID4i sandbox system. Have a look into for more details.


mvn install should do what you expect it to. Use it in the root module to build all clients or in each client module (i.e. sub-directory) separately.

Note that there is some redundancy within the client modules. This is a deliberate decision to have them self contained in an independent manner, so you have a standalone project for each tutorial without additional shared code/build script.


Each sample (module) has to be run separately.

Before running a sample, you need to set at least two environment variables to tell the app which API key and secret to use: ID4I_API_KEY and ID4I_API_KEY_SECRET. During development you will typically do this in your IDEs run configuration.

Having built the jar, you can just run it.

See the description of the individual modules for additional instructions.

$ cd first-client
$ ID4I_API_KEY=19323ddfc-27a2-43cd-ad51-bfe23a87b32234f
$ ID4I_API_KEY_SECRET=qaSdm4G94ojfsdklmUW7VIw3RJeYinKkxBu/6z8Sjvlsz2+X"
$ java -jar target/id4i-api-client-sample-java-1.0-SNAPSHOT-jar-with-dependencies.jar


If you have samples to contribute, feel free to open a PR (and/or contact us). If something does not work for you, please raise an issue in this repository. If you need other examples, let us know which by also opening an issue here.

1. When using asymmetric signing, you would use your public key here.
You can’t perform that action at this time.