Eliminar invitados

Elimina un usuario invitado de Kintone. Para eliminar a un usuario de un espacio de invitado sin eliminar su cuenta, utilice la API de actualización de miembros invitados. Para obtener más información, consulte el siguiente artículo:
Actualizar a los miembros invitados

MétodoDELETE
URLhttps://{subdomain}.kintone.com/k/v1/guests.json
Autenticación Autenticación de contraseña , Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

  • Solo los administradores de Kintone pueden usar esta API.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
guests Arreglo Una lista de direcciones de correo electrónico de usuarios invitados.
Se pueden eliminar hasta 100 invitados.

Solicitud de muestra

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
var body = {
  'guests': [
    'guest1@example.com',
    'guest2@example.com',
    'guest3@example.com'
  ]
};

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

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
var body = {
  'guests': [
    'guest1@example.com',
    'guest2@example.com',
    'guest3@example.com'
  ],
  // CSRF TOKEN: used for all APIs that have an HTTP method of POST, PUT and DELETE on Kintone.
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/k/v1/guests.json';
var xhr = new XMLHttpRequest();
xhr.open('DELETE', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(JSON.stringify(body));

Parámetros de respuesta

Se devolverá un objeto JSON vacío.

Ejemplo de respuesta

1
{}

Limitaciones

  • La configuración de activación/desactivación de las funciones Space o Guest Space no afecta a esta API.
  • Tenga en cuenta que su API no es para eliminar un usuario de un espacio de invitado, sino que se utiliza para eliminar la cuenta de usuario invitado.