Versión: BioStar v2.9.6 o superior

 

Si desea actualizar la información de un usuario específico, consulte el siguiente enlace: Actualizar API de usuario.

 

Este artículo te guiará a través de una nueva API compatible con la versión 2.9.6 que te permite editar hasta 100 usuarios a la vez. 

 

En lugar de editar un usuario a la vez, si tiene varios usuarios que le gustaría editar a la vez, esta API será útil.

Tenga en cuenta que no funcionará para más de 100 usuarios.

 

 

PUT /api/usuarios/masivo

 

Ejemplo)

 

Observe la información de los usuarios antes de llamar a la API en la siguiente captura de pantalla.

 

Cuando llame a esta API, deberá construir su cuerpo como se muestra a continuación en la captura de pantalla.

"Filas" tendrá una lista de usuarios que desea editar. 

Para cada elemento de "filas",  el campo "user_id" es obligatorio. Es el id del usuario que desea editar. 

Los campos restantes son cualquiera de los datos que desea editar para el usuario específico.

Puede encontrar los nombres de campo específicos y la información en Actualizar API de usuario

 

En el siguiente ejemplo, tengo 3 elementos en mis "filas".

Primero, estoy tratando de editar el nombre del usuario a 'Brad' para el usuario con ID de usuario '6'. 

En segundo lugar, estoy tratando de editar el correo electrónico del usuario a '@suprema.co.kr' para el usuario con ID de usuario '7'.

Por último, estoy tratando de editar el grupo de usuarios del usuario a '1011' (probando) para el usuario con ID de usuario '8'. 

 

 

Después de llamar a la API, si se realiza correctamente, recibirá un código de estado 200 con un cuerpo de respuesta que detalla los resultados del cambio.

 

En la respuesta, encontrarás el 'ret_code' para cada usuario indicando el resultado de cada edición

Será "0" (éxito) o algún otro código de error (ret_code) con un mensaje. 

Puede encontrar el significado del ret_code en el archivo C:\Program Files\BioStar 2(x64)\nginx\html\resources\messages_en.properties. 

 

El "código" en "Respuesta" es el resultado general de toda la API. 

0 - todas las ediciones se han realizado correctamente

1 -parcialmente exitoso

 

Si se produce un error en todas las ediciones, recibirás un código de estado 404 con response.code "8".

 

En el siguiente ejemplo, he editado con éxito la información de los tres usuarios y he recibido un '0' response.code y tres '0' ret_code.

 

Una captura de pantalla de una computadora

Descripción generada automáticamente 

Como puede ver a continuación, el usuario con el nombre de id '6' cambió de 'carolina' a 'Brad'.

La dirección de correo electrónico del usuario con ID '7' cambió a '@suprema.co.kr'.

El grupo de usuarios de usuario con ID '8' cambió de 'Todos los usuarios' a 'Pruebas'.