GET Audio/Podcasts Graph Metrics
Overview
The following table contains important information about the GET method in regards to receiving a graph of audio/podcast with desired metrics and interval types.
| GET Audio/Podcasts Graph Metrics | |
|---|---|
| Method | GET |
| URL or Endpoint | /api/v1/projects/projectId/audio/graph |
| Headers | Authorization |
| Parameters | metric, audioId, podcastId, isPodcast, intervalType,startDate, endDate, items, projectId |
| Body | Not Applicable |
The description of the URL parameter is as follows:
| projectId URL Parameter | |
|---|---|
| URL Parameter Name | projectId |
| Mandatory | Yes |
| Type | string |
| Description | Unique Id of the project |
The description of the parameters is as follows:
| Parameter Name | Mandatory | Type | Description |
|---|---|---|---|
| metric | No | integer($int32) | The metric to be used for the audio graph. Available values are: 0, 1, 2, 3, 4, 5. Default: 2 |
| audioId | No | string | Unique identifier of audio |
| podcastId | No | string | Unique identifier of podcast |
| isPodcast | No | boolean | A boolean value indicating whether it is a podcast |
| intervalType | Yes | integer($int32) | Types of intervals for receiving desired data(e.g., 0 for today) |
| startDate | No | string($date-time) | The start date you want to receive information for. |
| endDate | No | string($date-time) | The end date you want to receive information for. |
| items | No | integer($int32) | Number of items you want to receive |
| projectId | Yes | string | The id of the project. |
Request Body
The request does not contain a request body.
Response
{
"success": true,
"errors": [],
"messages": [],
"result": {
"graphResult": [
{
"result": 190,
"date": "2024-07-08T06:00:00"
}
],
"total": 190
},
"resultInfo": null,
"statusCode": 200
}
Information about the fields that appear when you receive the response are displayed in the table below.
| Field Name | Type | Description |
|---|---|---|
| success | bool | If the response is successful it will return true. Otherwise will return false. |
| errors | array | Indicates if there was an error. |
| messages | array | Returns the response messages from the back-end. |
| result | object | Returns the response object containing graphResult and total. |
| graphResult | array | Array of objects containing result (number) and date (timestamp) for each graph data point. |
| total | integer | Total count related to the result. |
| resultInfo | string | Additional information about the result |
| statusCode | integer | HTTP Status Code of the response. |
If the action is successful, the service sends back an HTTP 200 or 201 response.
Errors
For information about the errors that are common to all actions, see Common Errors:
HTTP Status Code 400: Bad Request
HTTP Status Code 401: Unauthorized
HTTP Status Code 403: Forbidden
HTTP Status Code 404: Result Not Found
HTTP Status Code 500: Internal Server Error
HTTP Status Code 503: Backend Fetch Failed