How To: Use the Titan API
Question
Does Titan provide an API?
Reasoning
I am interested in working with Titan Server programmatically.
Answer
Titan provides an
OpenAPI 3.0.x specification for its REST API, available at
https://<your-titan-server>/swagger/v1/swagger.json.
A public reference version is also on
GitHub, but always use your live server’s spec for the most accurate endpoints.
Steps
The Titan REST API is disabled by default. To enable the API, you will
need to create a configuration file in the
Titan executable's directory.
- Create a file named
appsettings.oem.json with the following content:
{
"ConfigSettings" : {
"RESTEnableSwaggerUI" : true,
"RESTEnableAdminApi" : true,
"RESTEnableUserApi" : false,
"RESTEnableBasicAuth" : false,
"RESTEnableDigestAuth" : true
}
} Copy this file into the Titan server’s install directory:
Windows: C:\Program Files\South River Technologies\srxserver\appsettings.oem.json
Linux: /srxserver/appsettings.oem.json
- Restart the Titan service to apply changes.
You should now be able to access https://<your-titan-server>:31443/swagger/index.html
(Port 41443 for remote login; check your deployment’s configuration.)
Examples