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

MétodoPUT
URLhttps://{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-Typeapplication/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:

  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 VALOR OBLIGATORIO DESCRIPCIÓN
app Cuerda El identificador de la aplicación.
records Arreglo 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 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 (External link)
records[].assignee Cuerda Opcional El siguiente cesionario. Especifique el nombre de inicio de sesión de la persona asignada.
records[].id Integer 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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
var body = {
  'app': 1,
  'records': [
    {
      'id': 4,
      'action': 'Start',
      'assignee': 'Krispy',
    },
    {
      'id': 3,
      'action': 'Complete'
    }
  ]
};

kintone.api(kintone.api.url('/k/v1/records/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
10
11
12
13
14
15
16
17
curl -X PUT 'https://{subdomain}.kintone.com/k/v1/records/status.json' \
-H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
-H 'Content-Type: application/json' \
-d '{
  "app": 1,
  "records": [
    {
      "id": 4,
      "action": "Start",
      "assignee": "Krispy"
    },
    {
      "id": 3,
      "action": "Complete"
    }
  ]
}'

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "records": [
    {
      "id": "4",
      "revision": "3"
    },
    {
      "id": "3",
      "revision": "4"
    }
  ]
}

Limitaciones

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