Subir archivo
Carga un archivo en Kintone.
Método | POST |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/file.json |
Autenticación | Autenticación de contraseña, Autenticación de token de API, Autenticación de sesión |
Content-Type | datos multiparte/formulario |
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.
Contenido
Permisos
No se necesitan permisos relacionados con los registros, ya que esta API no adjunta directamente un archivo a una aplicación.
Parámetros de solicitud
Formato de solicitud
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.
Solicitud de muestra
JavaScript
|
|
Muestra de curl
|
|
Parámetros de respuesta
Parámetro | Tipo | Descripción |
---|---|---|
fileKey | Cuerda | fileKey que representa un archivo cargado. Use esta clave de archivo con las siguientes API para adjuntarla a un campo de datos adjuntos de una aplicación: Agregar registro Agregar registros Actualizar registro Actualizar registros |
Ejemplo de respuesta
|
|
fileKeys
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.
Adjuntar el archivo a un campo de datos adjuntos
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
|
|
Limitaciones
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