Documentos de API

Eliminar registros

Elimina varios registros en una aplicación.

MétodoDELETE
URLhttps://{subdomain}.kintone.com/k/v1/records.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/records.json
Autenticación Autenticación de contraseña , Autenticación de token de API , Autenticación de sesión
Content-Typeapplication/json (no es necesario si se especifica la consulta con una cadena de consulta)

Contenido

Permisos

Se necesita permiso para eliminar registros dentro de la aplicación.

Parámetros de solicitud

PARÁMETRO VALOR OBLIGATORIO DESCRIPCIÓN
app Integer o String Sí El identificador de la aplicación.
ids Matriz de enteros o cadenas Sí Matriz de identificadores de registro que se eliminarán.
Se pueden especificar hasta 100 registros.
revisions Matriz de enteros o cadenas Opcional El número de revisión esperado.
El primer número de identificación corresponderá al primer número de revisión de la matriz, el segundo identificador al segundo número de revisión, y así sucesivamente.
Si el número de revisión no coincide, se producirá un error y no se eliminará ningún registro.
Si el número de revisión se deja en blanco o es -1, no se comprobará el número de revisión para el ID de registro correspondiente.

Solicitud de ejemplo (cadena de consulta)

JavaScript using kintone.api()

N/A - kintone.api() requiere que las solicitudes se envíen con el Content-Type:application/json para las solicitudes DELETE.

Muestra de curl 

1
2

curl -X DELETE 'https://{subdomain}.kintone.com/k/v1/records.json?app=287&ids[0]=1&ids[1]=2' -g \
  -H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx'

Solicitud de ejemplo (JSON)

JavaScript usando kintone.api() y JSON 

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

var body = {
  'app': 1,
  'ids': [1, 2]
};

kintone.api(kintone.api.url('/k/v1/records.json', true), 'DELETE', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

Muestra de curl 

1
2
3
4
5
6
7

curl -X DELETE 'https://{subdomain}.kintone.com/k/v1/records.json' \
  -H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
  -H 'Content-Type: application/json' \
  -d '{
    "app": 1,
    "ids": [1, 2]
  }'

Ejemplo de respuesta 

1

{}

Limitaciones

  • Si se produce un error en el proceso, no se eliminará ningún registro.
  • 100 es el número máximo de registros que se pueden eliminar por llamada a la API.