Bloomreach Cloud API - BloomReach Experience - Open Source CMS

Bloomreach Cloud API

The API documentation is available at https://api-<stack-name>.onehippo.io/v3/docs. Easiest is to copy/edit the Mission Control url to get this url.

It is best to use HTTP 1.1 to access the API to avoid side-effects of HTTP 2. Also notice that when doing CI/CD, the authentication token expires after 10 minutes, so it is best to have a single function that takes cares of the login and refresh of the token when 9 minutes have elapsed (see API docs on /v3/authn/refresh_token).


On a UNIX system, you can use curl to make API calls from the command line.

First, log in:

$ curl -X POST -H "Content-Type: application/json" -d '{"username":"[email protected]","password":"yourpassword"}' https://api-<stack-name>.onehippo.io/v3/authn/access_token

Note the authentication token in the response:

{"token_type":"bearer","access_token":"eyJhbG.......nkwZUWBBc","refresh_token":"d0ce....8cc3ee7c6"}

Next, use the authentication token from the previous response in subsequent calls.

You can also use the following script to add new user, though you require groovy to execute it. Replace the desired value in 'apiBase', you are good to add new users. Note that it does not do error handling/feedback very well.

 

Set up Continuous Deployment of your brXM Project in brCloud using Jenkins on the Bloomreach Developer Blog provides an example of how to set up continuous deployment using the Bloomreach Cloud API.

 

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?