Método uploadFile
Índice
Finalidad
Puede utilizar este método para adjuntar archivos a los registros.
Dirección URL de la solicitud
Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
Parámetros de la solicitud
| Parámetro | Tipo de datos | Descripción |
| authtoken* | Cadena | Cadena alfanumérica cifrada para autenticar sus credenciales de Zoho. |
| scope* | Cadena | Especifique el valor como crmapi |
| ID* | Cadena | Especifique el ID único del "registro" o "nota" al que se debe adjuntar el archivo. |
| contenido | FileInputStream | Apruebe el Flujo de ingreso de archivos del archivo |
| attachmentUrl | Cadena | Adjunte una dirección URL a un registro. |
*: parámetro obligatorio
Nota importante:
- El tamaño total del archivo no debe superar los 20 MB.
- El programa puede solicitar solo hasta 60 llamadas tipo uploadFile por minuto. Si el usuario de la API solicita más de 60 llamadas, el sistema bloqueará el acceso a la API durante 5 min.
- Si el tamaño excede los 20 MB, recibirá el siguiente mensaje de error: "El tamaño del archivo no debe exceder los 20 MB". Este límite no se aplica a las direcciones URL adjuntadas a través de attachmentUrl.
- El archivo adjunto estará disponible en la sección Archivos adjuntos en la página de detalles del registro.
- Los archivos se pueden adjuntar a registros de todos los módulos, excepto Informes, Paneles y Proyecciones.
- En el caso del parámetro attachmentUrl, el contenido no es necesario, ya que el archivo adjunto proviene de una dirección URL.
Por ejemplo, para attachmentUrl: crm/private/xml/Leads/uploadFile?authtoken=*****&scope=crmapi&id=<entity_id>&attachmentUrl=<insert_ URL>
Código Java para cargar un archivo a un registro
Puede ejecutar este programa en su entorno de Java para cargar un archivo a un registro.
En el programa, deberá especificar valores para los siguientes campos:
- Su token de autenticación
- El ID del registro
- La dirección URL de la solicitud uploadFile en el formato mencionado anteriormente
- La ruta del archivo, es decir, su ubicación
Ejemplo de respuesta
Límites de almacenamiento de datos
El valor predeterminado del almacenamiento gratuito disponible en la edición gratuita es de 1 GB por cuenta empresarial. Además de este 1 GB gratuito, los siguientes son los límites de almacenamiento de datos en cada edición pagada, por usuario.
- Edición profesional: 512 MB por licencia de usuario
- Edición estándar: 512 MB por licencia de usuario
- Edición empresarial: 1 GB por licencia de usuario
- CRM Plus: 1 GB por licencia de usuario
- Almacenamiento adicional de archivos: USD 4 al mes por 5 GB
En el caso de los usuarios existentes, se aplicarán los nuevos precios a partir del próximo ciclo de facturación.