Méthode uploadFile
Table des matières
Objectif
Vous pouvez utiliser cette méthode pour joindre des fichiers à des enregistrements.
URL de la requête
Format XML :
https://crm.zoho.com/crm/private/xml/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
Format JSON :
https://crm.zoho.com/crm/private/json/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
Paramètres de la requête
| Paramètre | Type de données | Description |
| authtoken* | Chaîne | Chaîne alphanumérique chiffrée utilisée pour l'authentification de vos identifiants Zoho. |
| scope* | Chaîne | Spécifiez la valeur comme crmapi. |
| id* | Chaîne | Spécifiez l'ID unique de l'« enregistrement » ou de la « note » auquel/à laquelle le fichier doit être joint. |
| content | FileInputStream | Transmettez le File Input Stream (Flux d'entrée de fichier) du fichier. |
| attachmentUrl | Chaîne | Joignez une URL à un enregistrement. |
* - Paramètre obligatoire
Remarque importante :
- La taille totale du fichier ne doit pas dépasser 20 Mo.
- Votre programme peut demander jusqu'à 60 appels uploadFile par minute. Si l'utilisateur de l'API demande plus de 60 appels, le système va bloquer l'accès à l'API pendant 5 min.
- Si la taille dépasse 20 Mo, vous recevrez le message d'erreur suivant : File size should not exceed 20 MB (La taille du fichier ne doit pas dépasser 20 Mo). Cette limite ne s'applique pas aux URL liées via attachmentUrl.
- Le fichier joint sera disponible dans la section Attachments (Pièces jointes) de la page Record Details (Détails de l'enregistrement).
- Des fichiers peuvent être joints à des enregistrements dans tous les modules sauf Reports (Rapports), Dashboards (Tableaux de bord) et Forecasts (Prévisions).
- Dans le cas du paramètre attachmentUrl, le contenu (content) n'est pas nécessaire car la pièce jointe vient d'une URL.
Exemple pour attachmentUrl : crm/private/xml/Leads/uploadFile?authtoken=*****&scope=crmapi&id=<entity_id>&attachmentUrl=<insert_ URL>
Code Java pour charger un fichier dans un enregistrement
Vous pouvez exécuter ce programme dans votre environnement Java pour charger un fichier dans un enregistrement.
Dans le programme, vous devez spécifier des valeurs pour les éléments suivants :
- Votre jeton d'authentification
- L'ID de l'enregistrement
- L'URL de demande uploadFile sous la forme mentionnée ci-dessus
- Le chemin d'accès du fichier, c'est-à-dire l'emplacement du fichier
Exemple de réponse
Limites de stockage des données
L'espace de stockage gratuit par défaut disponible dans l'édition gratuite est de 1 Go par compte d'entreprise. En plus de ces 1 Go gratuits, voici les limites de stockage de données dans chaque édition payante, applicables par utilisateur.
- Édition professionnelle - 512 Mo par licence utilisateur
- Édition standard - 512 Mo par licence utilisateur
- Édition d'entreprise - 1 Go par licence utilisateur
- CRM Plus - 1 Go par licence utilisateur
- Stockage supplémentaire de fichiers : 4 USD/mois/5 Go
Pour les utilisateurs existants, la tarification révisée sera applicable à partir du prochain cycle de facturation.