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
Permisos
- Solo los administradores de Kintone pueden usar esta API.
Parámetros de solicitud
Parámetro |
Valor |
Obligatorio |
Descripción |
guests |
Arreglo |
Sí |
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
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.