Actualizar a los miembros invitados

Documentos de API

Actualizar a los miembros invitados

Actualiza los miembros invitados de un espacio.

Método	PUT
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/space/guests.json
Autenticación	Autenticación de contraseña, Autenticación de sesión
Content-Type	application/json

Permisos

Solo el administrador del espacio de invitado puede utilizar esta API.

Parámetros de solicitud

Parámetro	Valor	Obligatorio	Descripción
id	Entero o cadena	Sí	El ID del espacio de invitado.
guests	Arreglo	Sí	Una lista de direcciones de correo electrónico de usuarios invitados. Los usuarios invitados primero deben agregarse como usuarios invitados de Kintone antes de que puedan afiliarse a Spaces. Para ello, utilice la API Add Guests. Para obtener más información, consulte el siguiente documento: Agregar invitados Los usuarios que no son usuarios invitados o que son usuarios inactivos o eliminados no se pueden agregar a la lista.

Solicitud de muestra

JavaScript using kintone.api()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


var body = {
  'id': 1001,
  'guests': [
    'guest1@example.com',
    'guest2@example.com',
    'guest3@example.com'
  ]
};

kintone.api(kintone.api.url('/k/guest/{guestspaceId}/v1/space/guests.json', false), 'PUT', 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
26


var body = {
  'id': 1001,
  '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/guest/{guestspaceId}/v1/space/guests.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', 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

Si la función Espacio o Espacio de invitado está desactivada, se devolverá un error.
Los usuarios invitados primero deben agregarse como usuarios invitados de Kintone antes de que puedan afiliarse a Spaces. Para ello, utilice la siguiente API:
Agregar invitados