Carga un archivo en Kintone.

Cuando se carga un archivo, se produce un fileKey.
Tenga en cuenta que, aunque esta API carga un archivo en Kintone, no carga el archivo en un campo de datos adjuntos de una aplicación.
Para cargar el archivo en un campo de datos adjuntos, el campo fileKey se utiliza con la API Add Record o Update Record.

No se necesitan permisos relacionados con los registros, ya que esta API no adjunta directamente un archivo a una aplicación.

La solicitud se envía en un formato de datos de formulario/multiparte. Para obtener más información, consulte los siguientes documentos RFC:

• RFC1867: Carga de archivos basada en formularios en HTML
• RFC7578: Devolver valores de formularios: multipart/form-data

Dentro de la Disposición de contenido , especifique "file" para el encabezado nombre y el nombre del archivo para el parámetro Nombre parámetro.

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

var blob = new Blob(['Sample Test File'], {type: 'text/plain'});
var formData = new FormData();
formData.append('__REQUEST_TOKEN__', kintone.getRequestToken());
formData.append('file', blob, 'test.txt');

var url = 'https://{subdomain}.kintone.com/k/v1/file.json';
var xhr = new XMLHttpRequest();
xhr.open('POST', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(formData);

1
2
3

curl -X POST 'https://{subdomain}.kintone.com/k/v1/file.json' \
  -H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
  -F 'file=@FILEPATH'

1
2
3

{
  "fileKey": " c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
}

Hay dos tipos de fileKeys que se usan en las API de REST de Kintone.

• Clave de archivo de la API de carga de archivos
  • Ejemplo: c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6
  • Esta clave de archivo se utiliza para actualizar un registro con un Archivo adjunto o agregue un registro con un archivo adjunto.
  • En este artículo se describe este tipo de fileKey
• Obtener la clave de archivo de la API de registro
  • Ex: 201202061155587E339F9067544F1A92C743460E3D12B3297
  • Esta clave de archivo se utiliza cuando Descargar Un archivo de un archivo Archivo adjunto campo.
  • En este artículo no se trata este tipo de fileKey.

Utilice las siguientes API y establezca el valor de la propiedad fileKey Como el fileKey obtenido de la API de carga de archivos, como se muestra en el cuerpo del ejemplo siguiente.
Agregar registro
Agregar registros
Actualizar registro
Actualizar registros

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

{
  "app": 3,
  "id": 6,
  "record": {
    "attached_file": {
      "value": [
        {
          "fileKey": " c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
        }
      ]
    }
  }
}

Solo se puede cargar 1 archivo a la vez.
Una vez cargado el archivo en Kintone, el archivo se eliminará después de 3 días si no se utiliza la API Add Record o Update Record.
No se puede llamar a esta API con la siguiente API:
API de solicitud de API REST de Kintone
Para conocer otras limitaciones, consulte el siguiente documento:
Limitaciones de la API REST de Kintone