Método uploadFile
Índice
Finalidade
Você pode usar esse método para anexar arquivos a registros.
Solicitar URL
Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=ID de registro&content=Fluxo de entrada de arquivo
Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=ID de registro&content=Fluxo de entrada de arquivo
Parâmetros de solicitação
Parâmetro | Tipo de dados | Descrição |
authtoken* | Sequência | Sequências alfanuméricas criptografadas para autenticar suas credenciais do Zoho. |
escopo* | Sequência | Especifique o valor como crmapi |
ID* | Sequência | Especifique o ID exclusivo do "registro" ou "nota" para o qual o arquivo será anexado. |
conteúdo | FileInputStream | Passe o Fluxo de entrada de arquivo do arquivo |
attachmentUrl | Sequência | Anexe um URL a um registro. |
* - Parâmetro obrigatório
Nota Importante:
- O tamanho total do arquivo não deve exceder 20 MB.
- O programa pode solicitar apenas até 60 chamadas uploadFile por minuto. Se o usuário da API solicitar mais de 60 chamadas, o sistema bloqueará o acesso à API por 5 minutos.
- Se o tamanho exceder 20 MB, você receberá a seguinte mensagem de erro: "O tamanho do arquivo não deve exceder 20 MB". Esse limite não se aplica a URLs anexados via attachmentUrl.
- O arquivo anexado estará disponível na seção Anexos na página Detalhes do Registro.
- Os arquivos podem ser anexados a registros em todos os módulos, exceto Relatórios, Painéis e Previsões.
- No caso do parâmetro attachmentUrl, o conteúdo não é necessário, pois o anexo é um URL.
Exemplo de attachmentUrl: crm/private/xml/Leads/uploadFile?authtoken=*****&scope=crmapi&id=<entity_id>&attachmentUrl=<insert_ URL>
Código Java para carregar um arquivo para um registro
Você pode executar esse programa no seu ambiente Java para carregar um arquivo para um registro.
No programa, você precisa especificar valores para o seguinte:
- Seu token de autenticação
- O ID do registro
- O URL de solicitação uploadFile no formato mencionado acima
- O caminho do arquivo, ou seja, o local do arquivo
Resposta da amostra
Limites de armazenamento de dados
O armazenamento livre padrão disponível na edição grátis é de 1 GB por conta de organização. Além desses 1 GB grátis, a seguir estão os limites de armazenamento de dados em cada edição paga, aplicáveis por usuário.
- Edição Professional - 512 MB por licença de usuário
- Edição Standard - 512 MB por licença de usuário
- Edição Enterprise - 1 GB por licença de usuário
- CRM Plus - 1 GB por licença de usuário
- Armazenamento extra de arquivos: US$4/mês/5 GB
Para usuários existentes, os preços revisados serão aplicáveis a partir do próximo ciclo de cobrança.