Estados de actualización
Actualiza los estados de varios registros de una aplicación, que se establecieron con Administración de procesos. Para obtener más información, consulte el siguiente artículo:
Gestión de Procesos
Método | PUT |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/records/status.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records/status.json |
Autenticación | Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión |
Content-Type | application/json |
Contenido
Permisos
Para la autenticación con contraseña, el usuario debe tener permiso para ver el registro. Además, se debe cumplir una de las siguientes condiciones:
- El usuario es el cesionario del registro
- No hay personas asignadas establecidas para el registro
Para la autenticación del token de API, el token de API debe tener permiso para ver el registro. Además, se debe cumplir una de las siguientes condiciones:
- El usuario "Administrador" es el Cesionario del registro
- No hay personas asignadas establecidas para el registro
Parámetros de solicitud
PARÁMETRO | VALOR | OBLIGATORIO | DESCRIPCIÓN |
---|---|---|---|
app | Cuerda | Sí | El identificador de la aplicación. |
records | Arreglo | Sí | Una matriz que incluye información del registro que se va a actualizar. Se pueden especificar hasta 100 registros. Si especifica más de 100 registros, se producirá un error. |
records[].action | Cuerda | Sí | El nombre de la acción que se va a ejecutar. Si la función de localización se ha utilizado para aplicar varias traducciones del nombre de la acción, especifique el nombre de la acción en la configuración de idioma del usuario que ejecutará la API. Los tokens de API siguen la configuración de idioma establecida en la configuración de Administración de usuarios y sistemas. Para obtener más información, consulte el siguiente artículo: Configuración del idioma del sistema |
records[].assignee | Cuerda | Opcional | El siguiente cesionario. Especifique el nombre de inicio de sesión de la persona asignada. |
records[].id | Integer | Sí | El ID de registro. |
records[].revision | Integer | Opcional | El número de revisión del registro antes de actualizar el estado. Si la revisión especificada no es la última, la solicitud producirá un error. La revisión no se comprobará si se ignora este parámetro o si se especifica -1. |
Solicitud de muestra
|
|
Muestra de curl
|
|
Parámetros de respuesta
PARÁMETRO | VALOR | DESCRIPCIÓN |
---|---|---|
records | Arreglo | Una matriz que incluye información de los registros actualizados. |
records[].id | Cuerda | El ID de registro |
records[].revision | Cuerda | El número de revisión del registro después de actualizar el estado. El número de revisión aumentará en 2, ya que se realizan dos operaciones: ejecutar la acción y actualizar el estado. |
Ejemplo de respuesta
|
|
Limitaciones
- Esta API solo se puede usar con aplicaciones que tengan habilitada la función Administración de procesos.