Next Generation REST APIs
The next generation of REST APIs to invoke the Oracle Utilities Testing Accelerator flow executions and retrieve results supports Open API specifications.
The authentication mechanism is the same for the next generation REST APIs as those used for the older REST APIs. For more information, refer to the
Prerequisites section. REST APIs can be invoked remotely using commands (such as curl) depending on the application that supports the commands.
To access Open API specifications for next generation REST APIs:
1. Open the following URL in a supported web browser:
<UTA URL>/swagger-ui/
Example: If the Oracle Utilities Testing Accelerator URL is https://someoraclecloudserver.com/prod/ccs/uta/, the corresponding swagger UI URL will be https://someoraclecloudserver.com/prod/ccs/uta/swagger-ui/.
2. The REST API specifications are documented on the page. The following figure shows Swagger UI with Open API specification for UTA REST APIs.
![Shos Swagger UI with Open API specification for UTA REST APIs. Shos Swagger UI with Open API specification for UTA REST APIs.](../UTA-USER-GUIDE/images/Swagger_UI.jpg)
Example curl command for running a UTA flow:
curl -k --request POST 'https:// someoraclecloudserver:8086/prod/ccs/uta/rest/v1/flow/run' \
--header 'Authorization: Basic U1lTVVNFUjpXZWxjb21lMTIzNDU2' \
--header 'Content-Type: application/json' \
--data '{
"configuration": "SCHED_54",
"flow": "QA-ToDoComplete",
"flowTestDataSet": "default",
"identity": "SCHED_54",
"portfolio": "CORE",
"product": "CORE",
"release": "UTA"
}'
The list of available APIs and the corresponding field definitions can be found in Oracle Utilities Testing Accelerator’s API specification.