Management APIs
Quickstart API
Quickstart accelerates getting you up and running with Hellō.
Software supporting Hellō Quickstart redirects the browser to the the Quickstart SPA (Single Page App) passing configuration parameters for the application. You then log into Quickstart with your Hellō Wallet (creating a wallet if you don't have one) and then confirm the name of your new application or select an existing one. Quickstart then provisions or updates your application and returns the client_id your application can use with Hellō.
You can add Hellō Quickstart to a sample application, plug-in, or other software module with the web redirect API below.
Launching Quickstart
You load the Quickstart App with the following query parameters:
Name | Description | |
---|---|---|
response_uri | Required | URI that Quickstart will redirect to with the client_id query parameter |
suffix | Optional | String that will be appended to the suggested name (eg: John's + suffix) for an app to be created. Defaults to "Application" |
name | Optional | Name of the application (suffix param is ignored if name param is provided) |
tos_uri | Optional | URI to the Terms of Service |
pp_uri | Optional | URI to the Privacy Policy |
image_uri | Optional | URI to the app logo |
dark_image_uri | Optional | URI to the dark theme app logo, which is shown if dark theme is detected in the browser |
redirect_uri | Optional | One or more space separated OAuth redirect_uri values to be added to the Production Redirect URIs http:\\localhost:* and http:\\127.0.0.1 Development Redirect URIs are enabled by default |
integration | Optional | Name of integration using Quickstart |
An example URL with params to quickstart will look like this:
(line feeds added & URL decoded for readability)
https://quickstart.hello.coop/
?response_uri=https://example.com/quickstart
&name=Hello World
&tos_uri=https://example.com/terms-of-service.html
&pp_uri=https://example.com/privacy-policy.html
&image_uri=https://example.com/logo.png
&dark_image_uri=https://example.com/logo-dark.png
&redirect_uri=https://example.com/response
&integration=wordpress
Quickstart Response
On completion, the Quickstart app will load the response_uri
with client_id
query parameter set to the Hellō Client ID.
https://example.com/quickstart
?client_id=ca12f47-f310-413b-b70f-4428d9448e8d
Admin API
This API is used by Console and Quickstart to manage Hellō Publishers & Applications. Please contact us if you would like to integrate Hellō Admin APIs into your management console.