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 , Autenticación OAuth 2.0
Content-Typeno es necesario (si se incluyen parámetros en el cuerpo de la solicitud, use application/json)

Contenido

Permisos

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

Parámetros de solicitud

Parámetro Tipo 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.