Agregar comentario de hilo

Agrega un comentario a un hilo de un espacio.

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

Contenido

Permisos

  • El usuario debe tener acceso al Espacio.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
space Entero o cadena El ID del espacio.
thread Entero o cadena El identificador del subproceso.
comment Objeto Un objeto que incluye detalles de comentario.
comment.text Cuerda Condicional El contenido del comentario.
LF puede especificar un salto de línea.
El número máximo de caracteres del comentario es 65535. Obligatorio, si comment.files no está establecido.
comment.files Arreglo Condicional Una matriz que incluye datos de archivos adjuntos.
El número máximo de archivos es 5.
Obligatorio, si comment.text no está establecido.
comment.files[].fileKey Cuerda Opcional fileKey del archivo adjunto.
fileKeys se puede encontrar a partir de la respuesta de la API de carga de archivos. Para obtener más información, consulte el siguiente artículo:
Subir archivo
comment.files[].width Entero o cadena Opcional Se puede especificar un ancho si el archivo adjunto es una imagen.
El mínimo es 100 y el máximo es 750.
Si se ignora este parámetro, se establecerá el ancho original (este ancho es del mismo tamaño que el tamaño cuando se elige "Original" al agregar una imagen a un hilo a través de la GUI). Este parámetro se ignora si el archivo no es una imagen.
comment.mentions Arreglo Opcional Una matriz que incluye menciones, que notifican a otros usuarios de Kintone.
comment.mentions[].code Cuerda Opcional El código del usuario, grupo o departamento que se mencionará.
El número máximo de menciones es de 10.
Los usuarios mencionados se colocarán delante del texto del comentario en la salida.
comment.mentions[].type Cuerda Opcional El tipo de entidad del destino mencionado.
  • USER: Usuario
  • GROUP: Grupo
  • ORGANIZATION: Departamento

Solicitud de muestra

 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
27
28
29
30
31
32
33
34
35
var body = {
  'space': 1001,
  'thread': 1001,
  'comment': {
    'text': 'This is the Golden Gate Bridge in San Francisco. \nIsn\'t it gorgeous?',
    'mentions': [
      {
        'code': 'john',
        'type': 'USER'
      },
      {
        'code': 'HR_EBbG2z',
        'type': 'ORGANIZATION'
      },
      {
        'code': 'Travel Club_9mhZNJ',
        'type': 'GROUP'
      }
    ],
    'files': [
      {
        'fileKey': 'a8c5360e-e919-4ac6-a300-b24fbc9ee1ec',
        'width': 400
      }
    ]
  }
};

kintone.api(kintone.api.url('/k/v1/space/thread/comment.json', true), 'POST', 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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
var body = {
  'space': 1001,
  'thread': 1001,
  'comment': {
    'text': 'This is the Golden Gate Bridge in San Francisco. \nIsn\'t it gorgeous?',
    'mentions': [
      {
        'code': 'john',
        'type': 'USER'
      },
      {
        'code': 'HR_EBbG2z',
        'type': 'ORGANIZATION'
      },
      {
        'code': 'Travel Club_9mhZNJ',
        'type': 'GROUP'
      }
    ],
    'files': [
      {
        'fileKey': 'a8c5360e-e919-4ac6-a300-b24fbc9ee1ec',
        'width': 400
      }
    ]
  },
  // 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/thread/comment.json';
var xhr = new XMLHttpRequest();
xhr.open('POST', 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

Parámetro Tipo Descripción
id Cuerda El identificador de comentario del comentario creado.

Ejemplo de respuesta

1
2
3
{
  "id": 78
}

Captura de muestras

Limitaciones

  • Si el nombre mencionado tiene una configuración de nombre localizada y el idioma del nombre localizado es el mismo que la configuración de idioma del autor del comentario, el nombre mencionado se publicará como el nombre localizado.
  • No se pueden mencionar usuarios, departamentos y grupos inactivos o eliminados.
  • Se producirán errores si menciona a un usuario que está siendo invitado al espacio de invitado, pero que aún no se ha unido.