Actualiza las personas asignadas de un estado de registro, que se estableció con Gestión de procesos. Para obtener más información, consulte el siguiente artículo:
Configuración de la gestión de procesos
Permisos
El usuario o el token de API deben tener permiso para administrar la aplicación y ver los registros.
Parámetros de solicitud
PARÁMETRO |
VALOR |
OBLIGATORIO |
DESCRIPCIÓN |
app |
Entero o cadena |
Sí |
El identificador de la aplicación. |
id |
Entero o cadena |
Sí |
El ID de registro. |
assignees |
Arreglo |
Sí |
La(s) clave(s) de usuario (nombres de inicio de sesión) de la(s) persona(s) asignada(s). Si está vacío, no se asignará ningún usuario. El número máximo de personas asignadas es de 100. |
revision |
Entero o cadena |
Opcional |
El número de revisión del registro antes de actualizar a las personas asignadas. 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
1
2
3
4
5
6
7
8
9
10
11
12
13
|
var body = {
'app': 1,
'id': 4,
'assignees': ['Krispy']
};
kintone.api(kintone.api.url('/k/v1/record/assignees.json', true), 'PUT', body, function(resp) {
// success
console.log(resp);
}, function(error) {
// error
console.log(error);
});
|
Muestra de curl
1
2
3
4
5
6
7
8
|
curl -X PUT 'https://{subdomain}.kintone.com/k/v1/record/assignees.json' \
-H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
-H 'Content-Type: application/json' \
-d '{
"app": 1,
"id": 4,
"assignees": ["Krispy"]
}'
|
Parámetros de respuesta
PARÁMETRO |
VALOR |
DESCRIPCIÓN |
revision |
Cuerda |
El número de revisión del registro después de actualizar las personas asignadas. |
Ejemplo de respuesta
1
2
3
|
{
"revision": "4"
}
|
Limitaciones
- Esta API solo se puede usar con aplicaciones que tengan habilitada la función Administración de procesos.
- El error se devolverá si se asignan más de 2 personas asignadas a un registro que solo permite una persona asignada.
Artículo relacionado