Simple REST API wrapper for the Omni infra-structure.
| Name | Type | Description |
|---|---|---|
| OMNI_BASE_URL | str |
The base URL that is going to be used for API connections (defaults to http://localhost:8080/mvc/). |
| OMNI_OPEN_URL | str |
The open URL for the Omni connection (defaults to OMNI_BASE_URL). |
| OMNI_PREFIX | str |
The default prefix to be used for API requests (defaults to adm/). |
| OMNI_ID | str |
The client id to be used for API connections (defaults to None). |
| OMNI_SECRET | str |
The secret key to be used for API connections (defaults to None). |
| OMNI_REDIRECT_URL | str |
The URL to be used for redirection OAuth based workflow (defaults to base,base.user,base.admin,foundation.store.list). |
| OMNI_USERNAME | str |
The username to be used on direct workflow (defaults to None). |
| OMNI_PASSWORD | str |
The password to be used on direct workflow (defaults to None). |
Typical usage of the Omni client implies the providing of the username and the password inside the target omni instance (Direct Mode).
api = omni.Api(
base_url = "http://frontdoorhq.com",
username = "YOUR_USERNAME",
password = "YOUR_PASSWORD"
)Alternatively it's possible to use the api throught an OAuth base approach using the provided client id and secret values.
api = omni.Api(
base_url = "http://frontdoorhq.com",
client_id = "YOUR_OAUTH_ID",
client_secret = "YOUR_OAUTH_SECRET"
)For these type of handling the OAuthAccessError exception must be handled and then
the user must be redirect to the url provided by api.oauth_autorize method call.
Running then the api.oauth_access call with the returned code from the server side
that should be used to redeem the access_token required for session authentication.
Examples are located here.
Omni API is currently licensed under the Apache License, Version 2.0.