Actualizar personas asignadas

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 (External link)

MétodoPUT
URLhttps://{subdomain}.kintone.com/k/v1/record/assignees.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/record/assignees.json
Autenticación Autenticación de contraseña, Autenticación de token de API, Autenticación de sesión
Content-Typeapplication/json

Contenido

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 El identificador de la aplicación.
id Entero o cadena El ID de registro.
assignees Arreglo 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