tree: cb565337ecf2bd58bcae316b778eae714b3bda95
  1. src/
  2. pom.xml
  3. postman-readme.md
  4. README.md
  5. unomi-postman-collection.json
rest/README.md

Apache Unomi REST API

Consumer documentation

The REST API is served under /cxs on the default HTTP port (8181).

Unomi 3.1 authentication:

AccessCredentials
Public endpoints (/cxs/context.json, /cxs/eventcollector, …)X-Unomi-Api-Key: <tenant-public-key>
Tenant private endpointsBasic auth tenantId:privateApiKey
System administration (tenants, cluster, tasks, …)JAAS user (for example karaf:karaf)

Key manual chapters:

  • manual/src/main/asciidoc/multitenancy.adoc — tenants and API keys
  • manual/src/main/asciidoc/request-examples.adoc — curl examples with auth
  • manual/src/main/asciidoc/useful-unomi-urls.adoc — endpoint reference
  • manual/src/main/asciidoc/scheduler.adoc/cxs/tasks API

Postman collections: see rest/postman-readme.md.

Generating Miredot API documentation (maintainers)

  • Switch to the rest-documentation branch (adds @Path annotations and the Maven plugin for doc generation).
  • Rebase on master: git rebase master.
  • Run mvn test.
  • Open target/miredot/index.html.