post https://{your-drive}.kommo.com/upload/
El método permite cargar una parte del archivo. La solicitud debe enviarse al host del servicio de archivos. El enlace completo que indica el session_token se retorna cuando se abre la sesión.
¿No sabes cuál es el nombre de tu unidad?
Consulta este artículo corto para averiguarlo.
¿Qué es un session_token?
Cuando creas una sesión de carga y obtienes una respuesta:
{
"max_file_size": 314572800,
"max_part_size": 131072,
"session_id": 106687453,
"upload_url": "https://drive-c.kommo.com/upload/eyJhbGciOiJIU...w6E6F5DCU0"
}
eyJhbGciOiJIU...w6E6F5DCU0 is your session_token.
Limitaciones
Este método está disponible para integraciones con el alcance Acceso a archivos.
Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error
Content-Type: application/json.
Parámetros de respuesta(NO es la parte final del archivo)
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| session_id | int | ID de la sesión |
| next_url | string | URL que se debe utilizar para cargar la siguiente parte del archivo |
Parámetros de respuesta (la parte final del archivo)
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| uuid | string | UUID de una versión del archivo |
| type | string | Tipo de versión del archivo. Parámetros posibles: imagen, video, audio, documento, archivo |
| name | string | Nombre de la versión del archivo |
| sanitized_name | string | Nombre de la versión del archivo en codificación ASCII |
| size | int | Tamaño de la versión del archivo en bytes |
| source_id | int|null | ID de la fuente de donde proviene la versión del archivo |
| has_multiple_versions | bool | Indica si el archivo tiene múltiples versiones |
| created_at | int | Hora de creación de la versión del archivo (Unix Timestamp) |
| created_by | object | ID del usuario que añadió la versión del archivo |
| created_by[id] | int | ID del usuario que añadió la versión del archivo |
| created_by[type] | string | Tipo de usuario que añadió la versión del archivo |
| updated_at | int | Hora en que la versión del archivo fue actualizada por última vez (Unix Timestamp) |
| updated_by | object | ID del usuario que actualizó la versión del archivo |
| deleted_at | int | Hora en que la versión del archivo fue eliminada (Unix Timestamp) |
| deleletd_by | object | ID del usuario que eliminó la versión del archivo |
| metadata | object|null | Metadatos del archivo |
| metadata[extension] | string | Extensión del archivo |
| metadata[mime_type] | string | Archivo de tipo MIME |
| previews | array|null | Arreglo de vistas previas para el archivo |
| previews[0] | object | Vista previa del archivo |
| previews[0][download_link] | string | URL para descargar la vista previa |
| previews[0][width] | int | Ancho de la vista previa |
| previews[0][height] | int | Alto de la vista previa |