Assist
Получение активных сессий
Section titled Получение активных сессийДоступно только в Enterprise Edition (EE).
Возвращает список активных сессий для конкретного проекта.
Метод
Section titled МетодGET
/api/v1/:projectKey/assist/sessions
Параметры
Section titled Параметры| Name | Type | Description |
|---|---|---|
| projectKey | string | ID отслеживаемого проекта (обязательно) |
Заголовки запроса
Section titled Заголовки запросаAuthorization: {YOUR_ORGANIZATION_API_KEY}: Ключ можно найти в разделе ‘Preferences’ > ‘Account’ > ‘Organization API
Key’.
Коды состояния
Section titled Коды состояния200: Ответ отправлен в формате JSON в теле
Пример запроса
Section titled Пример запросаcurl -X GET \
https://openreplay.example.com/api/v1/aYYaFHiagqdXKEmVlmvJ/assist/sessions \
-H 'content-type: application/json' \
-H 'Authorization: {YOUR_ORGANIZATION_API_KEY}'
Пример ответа
Section titled Пример ответа{
"data": {
"total": 1,
"sessions": [
{
"pageTitle": "OpenReplay Blog",
"sessionID": "6975518573799938",
"metadata": {},
"userID": "",
"userUUID": "8998545b-553c-4f41-a39d-d7cba7fac2d1",
"projectKey": "aYYaFHiagqdXKEmVlmvJ",
"revID": "",
"timestamp": 1656437966459,
"trackerVersion": "3.5.11",
"isSnippet": true,
"userOs": "Mac OS",
"userBrowser": "Chrome",
"userBrowserVersion": "103.0.0.0",
"userDevice": null,
"userDeviceType": "desktop",
"userCountry": "FR",
"active": false,
"live": true,
"projectId": 3
}
]
}
}
Поиск активных сессий
Section titled Поиск активных сессийПоиск в списке активных сессий конкретного проекта.
Метод
Section titled МетодPOST
/api/v1/:projectKey/assist/sessions
Параметры
Section titled Параметры| Name | Type | Description |
|---|---|---|
| projectKey | string | ID отслеживаемого проекта (обязательно) |
Payload
Section titled Payload| Name | Type | Description |
|---|---|---|
| sort | string | Атрибут сортировки (по умолчанию) |
| order | string | Порядок сортировки, может быть “DESC” или “ASC” (по умолчанию) |
| page | integer | Номер страницы для постраничной разбивки (по умолчанию:1) |
| limit | integer | Количество сессий на странице (по умолчанию:200) |
| filters | array of filter | Список фильтров, см. следующую таблицу (по умолчанию:[]) |
объект filter:
| Name | Type | Description |
|---|---|---|
| value | array of case insensitive strings | Список значений (по умолчанию:[]) |
| type | case insensitive string | Атрибут фильтра (обязательно) |
| source | case insensitive string | Имя атрибута метаданных для type=metadata (по умолчанию:"") |
| operator | case sensitive string | Оператор, применяемый к каждому значению, может быть “contains” или “is” (по умолчанию:“contains”) |
Поиск найдёт активные сессии, у которых имя атрибута содержит указанный type и значение которых содержит одно из указанных value.
P.S.: если values=[], поиск найдёт активные сессии, у которых есть заданный атрибут.
Например, если вы ищете сессии с определёнными метаданными (любое значение):
{"value": [], "type": "METADATA", "source": "myMeta"}
Заголовки запроса
Section titled Заголовки запросаAuthorization: {YOUR_ORGANIZATION_API_KEY}: Ключ можно найти в разделе ‘Preferences’ > ‘Account’ > ‘Organization API
Key’.
Коды состояния
Section titled Коды состояния200: Ответ отправлен в формате JSON в теле
Пример запроса
Section titled Пример запросаВ следующем примере выполняется поиск первых 10 активных сессий (в обратном порядке сортировки по timestamp), у которых
userId содержит ‘openreplay’ и metadata.plan содержит ‘trial’ или ‘free’.
curl -X POST \
https://openreplay.example.com/api/v1/aYYaFHiagqdXKEmVlmvJ/assist/sessions \
-H 'content-type: application/json' \
-H 'Authorization: {YOUR_ORGANIZATION_API_KEY}'
--data-raw '{
"filters": [
{
"value": [
"trial", "free"
],
"type": "METADATA",
"source": "plan",
"operator": "is"
},
{
"value": [
"openreplay"
],
"type": "USERID",
"operator": "contains"
}
],
"sort": "timestamp",
"order": "DESC",
"limit": 10,
"page": 1
}'
Пример ответа
Section titled Пример ответа{
"data": {
"total": 1,
"sessions": [
{
"pageTitle": "OpenReplay Blog",
"sessionID": "6975518573799185",
"metadata": {
"plan": "trial"
},
"userID": "dev@openreplay.com",
"userUUID": "8998545b-553c-4f41-a39d-d7cba7fac2d1",
"projectKey": "aYYaFHiagqdXKEmVlmvJ",
"revID": "",
"timestamp": 1656437966459,
"trackerVersion": "3.5.11",
"isSnippet": true,
"userOs": "Mac OS",
"userBrowser": "Chrome",
"userBrowserVersion": "103.0.0.0",
"userDevice": null,
"userDeviceType": "desktop",
"userCountry": "FR",
"active": false,
"live": true,
"projectId": 3
}
]
}
}