Jump to

• Request
• Response
• Examples

Get the top flows by duration

get

/timespent

This method gets the top flows by the time spent within the flows.

Request

Query Parameters

• duration: string
  Specifies the historical time, in days, which the returned data represents.

  Default Value: 7D

  Allowed Values: [ "7D", "30D", "60D", "90D" ]
• managerGuid: string
  Specifies the unique manager id, to filter the returned data. To be used with team scope.
• regionCode: string
  Specifies the unique region code, to filter the returned data. To be used with team scope.
• roleIdList: string
  Specifies the unique role id, to filter the returned data. To be used with team scope.
• scope: string
  Specifies the scope of the returned data. Team returns team data. Org returns organization data.

  Default Value: all

  Allowed Values: [ "all", "team" ]
• userGuid: string
  Specifies the unique user id, to filter the returned data. To be used with team scope.

There's no request body for this operation.

Security

• BasicAuth: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

successful operation

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object flowtimespent

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/flowtimespent"
    }
}

Nested Schema : flowtimespent

Type: object

Show Source

• averageResponseTime: integer (int64)
• flowName: string
• id: integer (int64)
• series: string
• timeSpent: integer (int64)
• users.: array users.

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "format":"int64"
        },
        "flowName":{
            "type":"string"
        },
        "series":{
            "type":"string"
        },
        "timeSpent":{
            "type":"integer",
            "format":"int64"
        },
        "averageResponseTime":{
            "type":"integer",
            "format":"int64"
        },
        "users.":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/flowtimespentsusers"
            }
        }
    }
}

Nested Schema : users.

Type: array

Show Source

• Array of: object flowtimespentsusers

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/flowtimespentsusers"
    }
}

Nested Schema : flowtimespentsusers

Type: object

Show Source

• averageResponseTime: integer (int64)
• manager: string
• managerGuid: string
• name: string
• region: string
• regionCode: string
• role: string
• roleId: string
• timespent: integer (int64)
• userGuid: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "timespent":{
            "type":"integer",
            "format":"int64"
        },
        "averageResponseTime":{
            "type":"integer",
            "format":"int64"
        },
        "manager":{
            "type":"string"
        },
        "role":{
            "type":"string"
        },
        "region":{
            "type":"string"
        },
        "roleId":{
            "type":"string"
        },
        "managerGuid":{
            "type":"string"
        },
        "regionCode":{
            "type":"string"
        },
        "userGuid":{
            "type":"string"
        }
    }
}

401 Response

Authentication Required

403 Response

Access Forbidden

Back to Top

Examples

The following example shows how to get the top flows by duration by submitting a get request on the REST resource using cURL.

cURL Command

curl -u <username:password> \ -X https://servername.fa.us2.oraclecloud.com/crmRestApi/clickhistory/resources/timespent

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "items": [
        {
            "series": "All",
            "timeSpent": 14,
            "averageResponseTime": 41,
            "flowName": "Workspace",
            "users": [],
            "id": 0
        },
        {
            "series": "All",
            "timeSpent": 3,
            "averageResponseTime": 0,
            "flowName": "Contextual Help",
            "users": [],
            "id": 1
        },
        {
            "series": "All",
            "timeSpent": 3,
            "averageResponseTime": 62,
            "flowName": "Access Groups",
            "users": [],
            "id": 2
        },
        {
            "series": "All",
            "timeSpent": 1,
            "averageResponseTime": 0,
            "flowName": "Credits and Earnings",
            "users": [],
            "id": 3
        }
    ]
}

Back to Top