uploadFile-Methode
Inhaltsverzeichnis
Zweck
Mit dieser Methode können Sie Dateien an Datensätze anhängen.
Anfrage-URL
XML-Format:
https://crm.zoho.com/crm/private/xml/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
JSON-Format:
https://crm.zoho.com/crm/private/json/Leads/uploadFile?authtoken=Auth Token&scope=crmapi&id=Record Id&content=File Input Stream
Anfrageparameter
| Parameter | Datentyp | Beschreibung |
| authtoken* | Zeichenfolge | Verschlüsselte alphanumerische Zeichenfolge zur Authentifizierung Ihrer Zoho-Anmeldedaten |
| scope* | Zeichenfolge | Geben Sie den Wert als crmapi an. |
| id* | Zeichenfolge | Geben Sie eine eindeutige ID des "Datensatzes" oder der "Notiz" an, an welche die Datei angehängt werden soll. |
| Inhalt | FileInputStream | Übergeben Sie FileInput Stream der Datei |
| attachmentUrl | Zeichenfolge | Eine URL an einen Datensatz anhängen |
* – Pflichtparameter
Wichtiger Hinweis:
- Die Gesamtdateigröße sollte 20 MB nicht überschreiten.
- Ihr Programm kann nur bis zu 60 uploadFile-Aufrufe pro Minute anfordern. Wenn der API-Benutzer mehr als 60 Aufrufe anfordert, blockiert das System den API-Zugriff für 5 Minuten.
- Wenn die Größe 20 MB überschreitet, erhalten Sie die folgende Fehlermeldung: "Die Dateigröße darf 20 MB nicht überschreiten". Diese Einschränkung gilt nicht für URLs, die über attachmentUrl angehängt werden.
- Die angehängte Datei wird im Abschnitt "Anlagen" auf der Seite Datensatzdetails verfügbar sein.
- Dateien können in allen Modulen mit Ausnahme von "Reports", "Dashboards" und "Forecasts" an Datensätze angehängt werden.
- Im Falle des Parameters attachmentUrl ist der Inhalt nicht erforderlich, da der Anhang von einer URL stammt.
Beispiel für attachmentUrl: crm/private/xml/Leads/uploadFile?authtoken=*****&scope=crmapi&id=<entity_id>&attachmentUrl=<insert_ URL>
Java-Code zum Hochladen einer Datei in einen Datensatz
Sie können dieses Programm in Ihrer Java-Umgebung ausführen, um eine Datei in einen Datensatz hochzuladen.
Im Programm müssen Sie für Folgendes Werte angeben:
- Ihren Authentifizierungstoken
- Die ID des Datensatzes
- Die uploadFile Anfrage-URL im oben genannten Format
- Den Dateipfad, d. h. den Speicherort der Datei
Beispielantwort
Grenzen der Datenspeicherung
Der in der Free Edition verfügbare kostenlose Standardspeicherplatz beträgt 1 GB pro Unternehmenskonto. Zusätzlich zu diesen kostenlosen 1 GB sind im Folgenden die Datenspeichergrenzen in jeder kostenpflichtigen Edition aufgeführt, die pro Benutzer gelten.
- Professional Edition – 512 MB pro Benutzerlizenz
- Standard Edition – 512 MB pro Benutzerlizenz
- Enterprise Edition – 1 GB pro Benutzerlizenz
- CRM-Plus – 1 GB pro Benutzerlizenz
- Zusätzlicher Dateispeicher: 4 USD/Monat/5 GB
Für bestehende Benutzer gilt die überarbeitete Preisgestaltung ab dem nächsten Abrechnungszyklus.