This is a Java API client for communicating with the Nuts Node, the reference implementation of the Nuts Specification. It is generated from the latest version of the OpenAPI specifications of the Nuts Node REST API.
<dependency>
<groupId>nl.reinkrul.nuts</groupId>
<artifactId>java-client</artifactId>
<version>5.2.0-rc.1</version>
</dependency>
Find all versions on Maven central.
The example below instantiates the API client for VDR and calls getDID
for subjectDID
:
var apiClient = new nl.reinkrul.nuts.ApiClient();
var didApi = new nl.reinkrul.nuts.vdr.DidApi(apiClient);
var didDocument = didApi.getDID(subjectDID, null, null);
// do something with the resolved DID Document
Since each module in the Nuts Node has its own OpenAPI specification, there is a client API generated for each of them.
You can find in their own subpackage in nl.reinkrul.nuts
(e.g. nl.reinkrul.nuts.vdr
).
See src/test/java/CredentialExamples.java
for how to issue NutsOrganizationCredential
and NutsAuthenticationCredential
.
This library will follow the major versioning of the Nuts Node. So if Nuts Node 1.x.x
is released, this library will follow with a 1.y.z
release.
Minor and patch versions will not follow the Nuts Node and are intended for features/bugfixes of the library.
Run make
:
- Fetches the latest version of the OpenAPI specifications.
- Generates the API client.
-
Update
nuts.version
version inpom.xml
. -
Run
make build
-
Update artifact version to next major/minor (to
x.y.z
) and then release.make release
-
Log in to Sonatype and close & release staging repository (see https://central.sonatype.org/publish/publish-maven/).
-
Update dependency version in
pom.xml
to the new version, update examples if required, commit and push.