Skip to main content

Reporting API v1.1.4-beta.5

Reporting API

info

You are viewing REST API documentation. This documentation is auto-generated from a swagger specification which itself is generated from annotations in the source code of the project. It is possible that this documentation includes bugs and that code samples are incomplete or wrong.

Authentication

  • OAuth 2.0 Authorization. Authenticate using Client Credentials

  • HTTP Authentication, scheme: Bearer Jwt Bearer Token Access

metrics-controller

retrieve yearly values for a year range

GET http://localhost:8080/api/reporting/metrics/yearly/{metric}?startYear=0&endYear=0 HTTP/1.1
Host: localhost:8080
Accept: application/json

retrieve yearly values for a year range

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
startYearqueryinteger(int32)truenone
endYearqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[YearlyMetricResult]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

[
{
"value": 0.1,
"year": 0
}
]

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/yearly/{metric}?startYear=0&endYear=0 \
-H 'Accept: application/json'

retrieve weekly values for a specific year

GET http://localhost:8080/api/reporting/metrics/weekly/{metric}?year=0 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve weekly values for a specific year

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[WeeklyMetricResult]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» weekinteger(int32)falsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/weekly/{metric}?year=0 \
-H 'Accept: */*'

retrieve accumulated values so far

GET http://localhost:8080/api/reporting/metrics/total/{metric} HTTP/1.1
Host: localhost:8080
Accept: application/json

retrieve accumulated values so far

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKMetricResult
400Bad RequestBad RequestInline
Response Schema

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

{
"value": 0.1
}

400 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/total/{metric} \
-H 'Accept: application/json'

retrieve monthly values for a specific year

GET http://localhost:8080/api/reporting/metrics/monthly/{metric}?year=0 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve monthly values for a specific year

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[MonthlyMetricResult]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» monthinteger(int32)falsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/monthly/{metric}?year=0 \
-H 'Accept: */*'

retrieve monthly values for all organizations (internal use)

GET http://localhost:8080/api/reporting/metrics/internal/monthly/{metric}?year=0&month=1 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve monthly values for all organizations (internal use)

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone
monthqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[MonthlyMetricResultWithOrganization]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» monthinteger(int32)falsenonenone
» organizationIdstringfalsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/internal/monthly/{metric}?year=0&month=1 \
-H 'Accept: */*'

retrieve daily values for all organizations (internal use)

GET http://localhost:8080/api/reporting/metrics/internal/daily/{metric}?year=0&month=1&day=1 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve daily values for all organizations (internal use)

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone
monthqueryinteger(int32)truenone
dayqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[DailyMetricResultWithOrganization]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» monthinteger(int32)falsenonenone
» dayinteger(int32)falsenonenone
» organizationIdstringfalsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/internal/daily/{metric}?year=0&month=1&day=1 \
-H 'Accept: */*'

retrieve hourly values for a specific day

GET http://localhost:8080/api/reporting/metrics/hourly/{metric}?year=0&month=1&day=1 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve hourly values for a specific day

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone
monthqueryinteger(int32)truenone
dayqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[HourlyMetricResult]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» monthinteger(int32)falsenonenone
» dayinteger(int32)falsenonenone
» hourinteger(int32)falsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/hourly/{metric}?year=0&month=1&day=1 \
-H 'Accept: */*'

retrieve daily values for a specific month

GET http://localhost:8080/api/reporting/metrics/daily/{metric}?year=0&month=1 HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve daily values for a specific month

Parameters

ParameterInTypeRequiredDescription
metricpathstringtruevideo_calls_created, video_calls, interactions_created, ratings_submitted, rating_score_average, concurrent_calls_max, concurrent_calls_avg, conference_average_duration, call_average_duration, video_calls_performed, video_calls_abandoned, video_calls_with_small_duration, video_calls_with_normal_duration, video_calls_with_long_duration, cobrowse_sessions_created, cobrowse_sessions_performed, cobrowse_sessions_denied, cobrowse_sessions_abandoned, cobrowse_control_requested, cobrowse_control_accepted, cobrowse_control_denied, cobrowse_session_duration, users_authenticated
yearqueryinteger(int32)truenone
monthqueryinteger(int32)truenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
400Bad RequestBad RequestInline
Response Schema

Status Code 200

NameTypeRequiredRestrictionsDescription
anonymous[DailyMetricResult]falsenonenone
» valuenumber(double)falsenonenone
» yearinteger(int32)falsenonenone
» monthinteger(int32)falsenonenone
» dayinteger(int32)falsenonenone

Status Code 400

NameTypeRequiredRestrictionsDescription
» additionalPropertiesobjectfalsenonenone
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/metrics/daily/{metric}?year=0&month=1 \
-H 'Accept: */*'

audit-controller

retrieve audit logs

GET http://localhost:8080/api/reporting/audits?params=property1,string,property2,string&pageable=page,0,size,1,sort,string HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve filtered audit logs

Parameters

ParameterInTypeRequiredDescription
paramsqueryobjecttruenone
pageablequeryPageabletruenone

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKPageAuditLog
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/audits?params=property1,string,property2,string&pageable=page,0,size,1,sort,string \
-H 'Accept: */*'

retrieve audit application types

GET http://localhost:8080/api/reporting/audits/applications HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve available audit application types

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
Response Schema
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/audits/applications \
-H 'Accept: */*'

retrieve audit action types

GET http://localhost:8080/api/reporting/audits/actions HTTP/1.1
Host: localhost:8080
Accept: */*

retrieve available audit action types

Responses

Overview
StatusMeaningDescriptionSchema
200OKOKInline
Response Schema
Examples

200 Response

caution

To perform this operation, you must be authenticated by means of one of the following methods: BearerToken, OAuth2ClientCredentials

Code samples

curl -X GET http://localhost:8080/api/reporting/audits/actions \
-H 'Accept: */*'

Schemas

YearlyMetricResult

{
"value": 0.1,
"year": 0
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone

WeeklyMetricResult

{
"value": 0.1,
"year": 0,
"week": 0
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
weekinteger(int32)falsenonenone

MetricResult

{
"value": 0.1
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone

MonthlyMetricResult

{
"value": 0.1,
"year": 0,
"month": 0
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
monthinteger(int32)falsenonenone

MonthlyMetricResultWithOrganization

{
"value": 0.1,
"year": 0,
"month": 0,
"organizationId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
monthinteger(int32)falsenonenone
organizationIdstringfalsenonenone

DailyMetricResultWithOrganization

{
"value": 0.1,
"year": 0,
"month": 0,
"day": 0,
"organizationId": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
monthinteger(int32)falsenonenone
dayinteger(int32)falsenonenone
organizationIdstringfalsenonenone

HourlyMetricResult

{
"value": 0.1,
"year": 0,
"month": 0,
"day": 0,
"hour": 0
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
monthinteger(int32)falsenonenone
dayinteger(int32)falsenonenone
hourinteger(int32)falsenonenone

DailyMetricResult

{
"value": 0.1,
"year": 0,
"month": 0,
"day": 0
}

Properties

NameTypeRequiredRestrictionsDescription
valuenumber(double)falsenonenone
yearinteger(int32)falsenonenone
monthinteger(int32)falsenonenone
dayinteger(int32)falsenonenone

Pageable

{
"page": 0,
"size": 1,
"sort": [
"string"
]
}

Properties

NameTypeRequiredRestrictionsDescription
pageinteger(int32)falsenonenone
sizeinteger(int32)falsenonenone
sort[string]falsenonenone

AuditEvent

{
"timeStamp": "string",
"interactionId": "string",
"organizationId": "string",
"applicationId": "string",
"userId": "string",
"roles": [
"string"
],
"action": "CREATE",
"outcome": "SUCCESS",
"application": "RECORDING",
"detail": "string"
}

Properties

NameTypeRequiredRestrictionsDescription
timeStampstringfalsenonenone
interactionIdstringfalsenonenone
organizationIdstringfalsenonenone
applicationIdstringfalsenonenone
userIdstringfalsenonenone
roles[string]falsenonenone
actionstringfalsenonenone
outcomestringfalsenonenone
applicationstringfalsenonenone
detailstringfalsenonenone
Enumerated Values
PropertyValue
actionCREATE
actionCANCEL
actionRE_EXECUTE
actionURL_ATTACHMENT
actionURL_INLINE
actionSTART
actionSTOP
actionUPDATE
actionDELETE
actionACTIVATE
actionAPPOINTMENT_RE_SCHEDULE
actionAPPOINTMENT_RE_ASSIGN
actionASR_ADD_LANGUAGE
actionASR_REMOVE_LANGUAGE
actionASR_ADD_TRANSLATION_LANGUAGE
actionASR_REMOVE_TRANSLATION_LANGUAGE
outcomeSUCCESS
outcomeFAIL
applicationRECORDING
applicationCOMPOSITION
applicationAPPOINTMENT
applicationAPPLICATION
applicationASR
applicationWEBHOOK

AuditLog

{
"audit": {
"timeStamp": "string",
"interactionId": "string",
"organizationId": "string",
"applicationId": "string",
"userId": "string",
"roles": [
"string"
],
"action": "CREATE",
"outcome": "SUCCESS",
"application": "RECORDING",
"detail": "string"
}
}

Properties

NameTypeRequiredRestrictionsDescription
auditAuditEventfalsenonenone

PageAuditLog

{
"totalElements": 0,
"totalPages": 0,
"first": true,
"last": true,
"size": 0,
"content": [
{
"audit": {
"timeStamp": "string",
"interactionId": "string",
"organizationId": "string",
"applicationId": "string",
"userId": "string",
"roles": [
"string"
],
"action": "CREATE",
"outcome": "SUCCESS",
"application": "RECORDING",
"detail": "string"
}
}
],
"number": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"numberOfElements": 0,
"pageable": {
"offset": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"paged": true,
"pageNumber": 0,
"pageSize": 0,
"unpaged": true
},
"empty": true
}

Properties

NameTypeRequiredRestrictionsDescription
totalElementsinteger(int64)falsenonenone
totalPagesinteger(int32)falsenonenone
firstbooleanfalsenonenone
lastbooleanfalsenonenone
sizeinteger(int32)falsenonenone
content[AuditLog]falsenonenone
numberinteger(int32)falsenonenone
sort[SortObject]falsenonenone
numberOfElementsinteger(int32)falsenonenone
pageablePageableObjectfalsenonenone
emptybooleanfalsenonenone

PageableObject

{
"offset": 0,
"sort": [
{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}
],
"paged": true,
"pageNumber": 0,
"pageSize": 0,
"unpaged": true
}

Properties

NameTypeRequiredRestrictionsDescription
offsetinteger(int64)falsenonenone
sort[SortObject]falsenonenone
pagedbooleanfalsenonenone
pageNumberinteger(int32)falsenonenone
pageSizeinteger(int32)falsenonenone
unpagedbooleanfalsenonenone

SortObject

{
"direction": "string",
"nullHandling": "string",
"ascending": true,
"property": "string",
"ignoreCase": true
}

Properties

NameTypeRequiredRestrictionsDescription
directionstringfalsenonenone
nullHandlingstringfalsenonenone
ascendingbooleanfalsenonenone
propertystringfalsenonenone
ignoreCasebooleanfalsenonenone