Actualizar el cuerpo del espacio

Actualiza el cuerpo de un espacio.

MétodoPUT
URLhttps://{subdomain}.kintone.com/k/v1/space/body.json
URL (espacio de invitado)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/space/body.json
Autenticación Autenticación de contraseña, Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

  • Solo los administradores de espacio pueden utilizar esta API.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
id Entero o cadena El ID del espacio.
body Cuerda El contenido del cuerpo como una cadena HTML.
Las etiquetas HTML que no se puedan utilizar se eliminarán automáticamente.
HTML se puede usar para adjuntar aplicaciones, archivos y emojis.
El uso de la marca @ para mencionar a un usuario no notificará a ese usuario.

Solicitud de muestra

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
var body = {
  'id': 1001,
  'body': '<b>Sample Space Description</b>'
};

kintone.api(kintone.api.url('/k/v1/space/body.json', true), '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
var body = {
  'id': 1001,
  'body': '<b>Sample Space Description</b>',
  // 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/space/body.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.
  • Esta API solo se puede usar en espacios con varios subprocesos. Para actualizar el cuerpo de un solo espacio de subproceso, use la siguiente API:
    Hilo de actualización