users/{id-usuario}/history

Utilice este recurso para recuperar y exportar los sucesos del historial de cuenta de un usuario específico.

Nota: La documentación de la API se ha migrado a IBM API Hub El enlace externo abre una nueva ventana o pestaña

. Encuentre las últimas actualizaciones y documentación sobre Blueworks Live API en API Hub.

Resumen del método

Método HTTP	Vía de acceso	Descripción
GET	/bwl/users/{user-id}/history	Devuelve el historial de valores de cuenta de un usuario específico. Debe ser administrador o llamar utilizando un ID de servicio de gestión de usuarios.

GET/users/{user-id}/history

Descripción: Utilice este método para recuperar y exportar los sucesos del historial de cuenta del usuario.

Información de recursos

Requisitos	Descripción
Formato de la respuesta	JSON o CSV. Utilice el parámetro Accept para especificar el formato.
Requiere autenticación	Sí
Permite credenciales de cliente de OAuth 2	Sí utilizando un ID de servicio de usuario que contiene la categoría de gestión de usuarios

Parámetros

Nombre	Ubicación	Descripción	Obligatorio	Tipo
Accept	Cabecera	El formato que debe aceptarse. El valor debe ser `text/csv` o `application/json`. Si no se proporciona ningún valor, JSON es el formato predeterminado.	Nee	Serie
user-id	Vía de acceso	Identificador del usuario que debe recuperarse.	Sí	Serie

Respuesta

Entrada de ejemplo 1

Obtener (mediante GET) los sucesos del historial de cuenta de un usuario específico en formato CSV:

Utilizando las credenciales de cliente OAuth 2:

curl -i -H "Authorization: Bearer access_token" -H "Accept: text/csv"
    "https://your_server_url/bwl/users/260007/history"

Salida de ejemplo 1

Obtener (mediante GET) los sucesos del historial de cuenta de un usuario específico en formato CSV:


"Date","Target User (Email)","Made By (Email)","Made By (Full Name)","Change Type","Details" 
"Jun 30, 2020","bob@domain.com","bob@domain.com ","Bob","JOIN (EDITOR)","joined the account as an editor by invitation from Blueworks Live Support" 
"Jun 29, 2020", "bob@domain.com", "<Blueworks Live Support>","Blueworks Live Support","INVITE","invited bob@domain.com to join the account"

Entrada de ejemplo 2

Obtener (mediante GET) los sucesos del historial de cuenta de un usuario específico en formato JSON:

Utilizando las credenciales de cliente OAuth 2:

curl -i -H "Authorization: Bearer access_token" -H "Accept: text/json" 
    "https://your_server_url/bwl/users/260007/history"

Salida de ejemplo 2

Obtener (mediante GET) los sucesos del historial de cuenta de un usuario específico en formato JSON:

[ { "date" : "Jun 30, 2020",   
     "target-user": "bob@domain.com",
     "made-by-email" : "bob@domain.com", 
     "made-by-full-name": "Bob" 
      "change-type" : "JOIN (EDITOR)",  
     "details" : "joined the account as an editor by invitation from Blueworks Live Support"  }, 

{   "date" : "Jun 29, 2020",  
     "target-user": "bob@domain.com",
     "made-by-email" : "<Blueworks Live Support>",  
     "made-by-full-name": "Blueworks Live Support",
     "change-type" : "INVITE",   
     "details" : "invited bob@domain.com to join the account" } ]

Mensajes de respuesta

Código HTTP	Razón
200	La solicitud se ha completado correctamente.
400	Se ha producido un error al procesar la solicitud. Faltaban algunos parámetros obligatorios o contenían valores no válidos.
401	Este usuario no ha pasado la autenticación. Esta respuesta puede aparecer por las siguientes razones: Se ha proporcionado un nombre de usuario o contraseña no válidos. Este usuario pertenece a varias cuentas y no se ha especificado una cuenta en la solicitud.
403	El acceso está prohibido porque el usuario no es administrador de la cuenta.
404	El parámetro user-id identifica un usuario que no existe en esta cuenta.