Assist

Cómo buscar en todas las sesiones en vivo de un proyecto concreto.

Assist

Solo disponible para Enterprise Edition (EE).

Devuelve la lista de sesiones en vivo de un proyecto concreto.

GET

/api/v1/:projectKey/assist/sessions

NameTypeDescription
projectKeystringEl ID del proyecto que estás monitorizando (obligatorio)

Authorization: {YOUR_ORGANIZATION_API_KEY}: La clave se encuentra en ‘Preferences’ > ‘Account’ > ‘Organization API Key’.

200: Respuesta enviada como JSON en el cuerpo

curl -X GET \
  https://openreplay.example.com/api/v1/aYYaFHiagqdXKEmVlmvJ/assist/sessions \
  -H 'content-type: application/json' \
  -H 'Authorization: {YOUR_ORGANIZATION_API_KEY}'
{
  "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
      }
    ]
  }
}

Busca en la lista de sesiones en vivo de un proyecto concreto.

POST

/api/v1/:projectKey/assist/sessions

NameTypeDescription
projectKeystringEl ID del proyecto que estás monitorizando (obligatorio)
NameTypeDescription
sortstringEl atributo de ordenación (por defecto
)
orderstringEl orden de clasificación, puede ser “DESC” o “ASC” (por defecto
)
pageintegerEl número de página para la paginación (por defecto:1)
limitintegerEl número de sesiones por página (por defecto:200)
filtersarray of filterLa lista de filtros, consulta la tabla siguiente (por defecto:[])

objeto filter:

NameTypeDescription
valuearray of case insensitive stringsLa lista de valores (por defecto:[])
typecase insensitive stringEl atributo del filtro (obligatorio)
sourcecase insensitive stringEl nombre del atributo de metadatos para type=metadata (por defecto:"")
operatorcase sensitive stringEl operador que se aplica a cada valor, puede ser “contains” o “is” (por defecto:“contains”)

La búsqueda buscará las sesiones en vivo que tengan un nombre de atributo que contenga el type indicado y que tengan un valor que contenga 1 de los value indicados.

PD: si values=[]; la búsqueda buscará las sesiones en vivo que tengan un atributo determinado.

Por ejemplo, si buscas sesiones que tengan unos metadatos específicos (cualquier valor):

{"value": [], "type": "METADATA", "source": "myMeta"}

Authorization: {YOUR_ORGANIZATION_API_KEY}: La clave se encuentra en ‘Preferences’ > ‘Account’ > ‘Organization API Key’.

200: Respuesta enviada como JSON en el cuerpo

El siguiente ejemplo buscará las primeras 10 sesiones en vivo (ordenadas de forma descendente por timestamp) que tengan un userId que contenga ‘openreplay’ y metadata.plan que contenga ‘trial’ o ‘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
   }'
{
  "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
      }
    ]
  }
}