Troubleshooting the REST API
To understand errors from the REST API, examine the status code of the response along with the response body if present. If that does not help, and you have access to the appliance's logs, look at the log file for the REST API subsystem (setting the log level to DEBUG temporarily can be useful).
Also, here are some specific scenarios you might encounter:
I can't connect to the API at all over HTTPS
Configure HTTPS or enable API access over HTTP.
I keep getting 403 Forbidden errors back from the API
This error occurs if you have configured HTTPS and you try to access HTTP. If your HTTP(S) configuration is correct, but you still receive 403 errors, the user accessing the API might not have permission to perform the actions required by the endpoint.
I keep getting 401 Unauthorized errors back from the API
This error indicates that you could not be authenticated using the token expected in the HTTP "Authorization" header. Several reasons could cause this problem:
- The "Authorization" header itself is missing or invalid.
- The token is missing from the header or is invalid.
- The token has expired. Note that tokens only expire if they are generated from the
/api/tokenendpoint (as opposed to being generated in the user interface). In this case, you can generate a new one with another call to the same endpoint. If you are using the Swagger UI, the interaction with
/api/tokenis hidden from you, but you can trigger another call to the endpoint by refreshing the Swagger UI and entering your username and password again.
- The user that owns the token has been deactivated or deleted.
Both the new UI and the REST APIs run on Jetty.
The Jetty server does not respond to client REST API request. The new BMC CMDB user interface does not launch.
This issue is observed when you configure the Jetty server by using a secured socket layer (SSL). Perform the following steps:
- Open the arserver.config file, located in the <Install directory>\ARSystem folder.
- Add the following line in the arserver.config file.
How to turn on logging for REST API related issues
For information about turning on logging for REST API related issues, see the https://communities.bmc.com/docs/DOC-96343 article on BMC Communities.