CDC Application APIs
Access to REST API operations is only available to users with a business plan subscription.
Gathr’s REST API supports the following actions on CDC applications:
Start CDC Application
This API will start a Gathr CDC application with the following REST call.
Request URL
POST https://app.gathr.one/api/v1/application/start
Headers
| Parameter Name | Description |
|---|---|
Content-Type | application/json |
Authorization | < gathr-user-token > |
Request Body
{
"name":"<your_cdc_app_name>",
"appType":"cdc",
"groupName":"<your_cdc_app_group_name>",
"projectName":"<your_project_name>"
}
Request Body Parameters
| Name | Required | Description |
|---|---|---|
name | YES | The name of the CDC application to be started. |
appType | YES | The type of the Gathr application that should be started. Value to be provided - cdc |
projectName | YES | The group name of the CDC application to be started. |
projectName | YES | Gathr project name containing CDC application to be started. |
Response
HTTP Status Code: 200
{"message": "Request to start the application is accepted.",
"status": "Success"}
HTTP Status Code: 400
{"message": "<A description of the error will be provided.>",
"status": "Error"}
Stop CDC Application
This API will stop a Gathr CDC application with the following REST call.
Request URL
POST https://app.gathr.one/api/v1/application/stop
Headers
| Parameter Name | Description |
|---|---|
Content-Type | application/json |
Authorization | < gathr-user-token > |
Request Body
{
"name":"<your_cdc_app_name>",
"appType":"cdc",
"groupName":"<your_cdc_app_group_name>",
"projectName":"<your_project_name>"
}
Request Body Parameters
| Name | Required | Description |
|---|---|---|
name | YES | The name of the CDC application to be stopped. |
appType | YES | The type of the Gathr application that should be stopped. Value to be provided - cdc |
groupName | YES | The group name of the CDC application to be stopped. |
projectName | YES | The Gathr project name containing the CDC application to be stopped. |
Response
HTTP Status Code: 200
{"message": "Request to stop the application is accepted.",
"status": "Success"}
HTTP Status Code: 400
{"message": "<A description of the error will be provided.>",
"status": "Error"}
Get CDC Application Status
This API will get the status of a Gathr CDC application with the following REST call.
Request URL
GET https://app.gathr.one/api/v1/application/status/<appType>/<appName>
Headers
| Parameter Name | Description |
|---|---|
Content-Type | application/json |
Authorization | < gathr-user-token > |
Query Parameters
| Name | Required | Description |
|---|---|---|
appType | YES | The type of the Gathr application to fetch the status. Value to be provided - cdc |
appName | YES | The group name of the CDC application for which the status is to be fetched. |
Response
HTTP Status Code: 200
{"application_status": "STOPPED",
"status": "Success"}
{"application_status": "STARTING",
"status": "Success"}
{"application_status": "RUNNING",
"status": "Success"}
{"application_status": "ERROR",
"status": "Success"}
HTTP Status Code: 400
{"message": "<A description of the error will be provided.>",
"status": "Error"}
If you have any feedback on Gathr documentation, please email us!