Actualiza el estado de un registro de una aplicación, 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

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:

1. El usuario es el cesionario del registro
2. 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:

1. El usuario "Administrador" es el Cesionario del registro
2. No hay personas asignadas establecidas para el registro

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
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
app	Integer	Sí	El identificador de la aplicación.
assignee	Cuerda	Requerido condicionalmente	El siguiente cesionario. Especifique el nombre de inicio de sesión de la persona asignada. Es obligatorio si se cumple una de las siguientes condiciones: si el "Lista de asignados" del estado actual está configurado en "El usuario elige un asignado de la lista para actuar", y existe un asignado seleccionable. si el "Lista de asignados" del estado inicial se ha establecido en un assignee, y el estado se revierte a ese estado inicial.
id	Integer	Sí	El identificador de registro.
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

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

var body = {
  'app': 1,
  'id': 3,
  'action': 'Start',
  'assignee': 'Krispy',
};

kintone.api(kintone.api.url('/k/v1/record/status.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
9

curl -X PUT 'https://{subdomain}.kintone.com/k/v1/record/status.json' \
-H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
-H 'Content-Type: application/json' \
-d '{
  "app": 1,
  "id": 3,
  "action": "start",
  "assignee": "Krispy"
}'

Parámetros de respuesta

Ejemplo de respuesta

1
2
3

{
  "revision": "3"
}

Limitaciones

• Esta API solo se puede usar con aplicaciones que tengan habilitada la función Administración de procesos.