This repository contains a distilled and documented demonstration of using the nuid.credential authentication library in Clojure to interact with NuID's Auth API. The library works identically from ClojureScript.

The primary goal of this repository is to demonstrate the request and response data for each endpoint, as well as the relationship between endpoints in a typical authentication flow. In other words, nuid.clj-example is not intended to be used as a bundled client library or dependency, although one of those is on our roadmap! Similar logic could be expressed many different ways according to specific needs, dependencies, etc.. We'd love to help adapt and expand this example to other contexts, so get in touch!

Additional documentation can be found by registering for an API Key and reading the documentation in the portal. We will be publishing prettier and better in every way documentation over the coming months. And always feel welcome to reach out with any questions that arise.

• jvm
• clj
• An API Key (freely available at the portal)

The example is meant to be explored in the REPL. It is recommended to evaluate individual forms and inspect request and response data.

The typical starting point will be to open the nuid.clj-example namespace and start a REPL from the namespace as prescribed by your editor and configuration. Once the REPL has been started and the namespace has been evaluated, the forms in the (comment ,,,) block will invoke the API with the appropriate data.

Apache v2.0 or MIT