post https://{seu-drive}.kommo.com/upload/
O método permite o envio de uma parte do arquivo. A solicitação deve ser enviada para o host do serviço de arquivos. O link completo indicando o session_token é retornado quando a sessão é aberta.
Infelizmente, você não poderá enviar um arquivo por meio desta página. Por favor, escolha uma ferramenta diferente.
Não sabe qual é o nome do seu drive?
Leia um artigo curto para descobrir.
O que é um session_token?
Você cria uma sessão de upload e recebe uma resposta:
{
"max_file_size": 314572800,
"max_part_size": 131072,
"session_id": 106687453,
"upload_url": "https://drive-c.kommo.com/upload/eyJhbGciOiJIU...w6E6F5DCU0"
}
eyJhbGciOiJIU...w6E6F5DCU0
é seu session_token
.
Limitações
O método está disponível para integrações com escopo definido como Acesso a arquivos.
Quando a solicitação for bem-sucedida ou em caso de erro
Content-Type: application/json
Parâmetros de resposta (NÃO é a parte final do arquivo)
Parâmetro | Tipo de dado | Descrição |
---|---|---|
session_id | int | ID da sessão |
next_url | string | URL que deve ser usada para enviar a próxima parte do arquivo |
Parâmetros de resposta (A parte final do arquivo)
Parâmetro | Tipo de dado | Descrição |
---|---|---|
uuid | string | UUID de uma versão do arquivo |
type | string | Tipo de versão do arquivo. Parâmetros possíveis – imagem, vídeo, áudio, documento, arquivo |
name | string | Nome da versão do arquivo |
sanitized_name | string | Nome da versão do arquivo em codificação ASCII |
size | int | Tamanho da versão do arquivo em bytes |
source_id | int|null | ID da origem de onde veio a versão do arquivo |
has_multiple_versions | bool | Indica se o arquivo tem várias versões |
created_at | int | Tempo de criação da versão do arquivo no formato Unix Timestamp |
created_by | object | ID do usuário que adicionou a versão do arquivo |
created_by[id] | int | ID do usuário que adicionou a versão do arquivo |
created_by[type] | string | Tipo de usuário que adicionou a versão do arquivo |
updated_at | int | Tempo da última atualização da versão do arquivo (Unix Timestamp) |
updated_by | object | ID do usuário que atualizou a versão do arquivo |
deleted_at | int | Tempo em que a versão do arquivo foi excluída (Unix Timestamp) |
deleletd_by | object | ID do usuário que excluiu a versão do arquivo |
metadata | object|null | Metadados do arquivo |
metadata[extension] | string | Extensão do arquivo |
metadata[mime_type] | string | Tipo MIME do arquivo |
previews | array|null | Array de pré-visualizações do arquivo |
previews[0] | object | Pré-visualização do arquivo |
previews[0][download_link] | string | URL para baixar a pré-visualização |
previews[0][width] | int | Largura da pré-visualização |
previews[0][height] | int | Altura da pré-visualização |