Getting started with the BMC Digital Workplace Catalog REST API
The API follows the REST architectural style, so resources, HTTP verbs, and status codes are used. JSON is used for request and response bodies.
Access to the BMC Digital Workplace Catalog REST API is over the transport scheme configured for your application server, either HTTP or HTTPS. You can call API endpoints from any scripting or programming language that supports the configured transport scheme.
The default configuration supports an HTTP connection. For information on configuring the HTTPS connection, see Configuring access to the BMC Digital Workplace Catalog server over SSL.
The following base URI is used for calling the BMC Digital Workplace Catalog server: /api/myit-sb/
Call the API endpoint from the full application host URL. If the host URL includes a port number, include the port number in your requests. Preface the URL with the correct scheme (HTTP/HTTPS).
Following are examples of the base URI:
|Base URI format type||Example|
|A server without a port assigned to it|
Unless an API endpoint requires a different header, the following header is required for all requests:
default-bundle-scope: myit-sb Content-Type: application/json X-Requested-By: <any_value>
To be able to make REST API calls, you need to log in to the application by using the
users/login endpoint to be granted a session token, which is valid for about 30 minutes. The system-generated token must be included in all subsequent calls for the system to trust requests from the application or script that has been granted that token. This token is typically sent back and forth as a AR-JWT cookie, although it can also be included inside the header.