Agregar comentario de hilo

Documentos de API

Agregar comentario de hilo

Agrega un comentario a un hilo de un espacio.

Método	POST
URL	https://{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-Type	application/json

Permisos

El usuario debe tener acceso al Espacio.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción
space	Entero o cadena	Sí	El ID del espacio.
thread	Entero o cadena	Sí	El identificador del subproceso.
comment	Objeto	Sí	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. Si la renovación del marco de frontend está habilitada en las páginas de espacios e hilos, el límite máximo es de 100,000 caracteres. 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

JavaScript using kintone.api()

 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) {
  // éxito
  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: se utiliza para todas las APIs con método HTTP POST, PUT y DELETE en 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) {
    // éxito
    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.