Servicezentrum

Dateiverwaltung

Fehler beim Hinzufügen der Datei: fileKey existiert nicht, meldet „File cannot be found.

Bitte überprüfen Sie, ob Sie nach der Verwendung der Schnittstelle zum Abrufen der Dateiadresse die mit der abgerufenen URL die Datei per HTTP-PUT-Methode hochgeladen haben. Wenn Sie sie nicht hochgeladen haben, rufen Sie die URL zum Hochladen der Datei auf.

 

Wie lange ist die Gültigkeitsdauer der Datei-Upload-Adresse?

Datei-Upload-Adresse, LinkDie Gültigkeitsdauer der Verbindung beträgt 60 Minuten.

 

 

Die Dateiupload-Site während der Integration isthttps://file-sml.esignglobal.com/besonders langsam, das Hochladen von Dateien ist relativ langsam

Beim Andocken und Hochladen von Dateien in der Sandbox-Umgebung ist zu beachten, dass sich der Server in Singapur befindet. Wenn Sie direkt aus dem Inland darauf zugreifen, ist das Netzwerk oft instabil, und es treten häufig Probleme wie Verzögerungen, langsames Laden oder kein Zugriff auf. In Anbetracht dessen wird empfohlen, über einen Proxy in Singapur zuzugreifen, was dazu beitragen kann, die Netzwerkinstabilität zu verbessern und den Dateidienst bequemer zu nutzen.

 

 

openapi-Aufruf zum Abrufen der Dateiadresse erfolgreich, danach Fehler beim Hochladen der Datei

Schritt 1: Abrufen der Datei-Upload-Adresse. Während des Vorgangs müssen Sie die folgenden Informationen im folgenden Format angeben, um die Datei-Upload-Adresse abzurufen: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Bitte beachten Sie, dass der Dateiname hier zwar „fengniantest.pdf“ lautet, der Inhaltstyp (contentType) jedoch als „application/pdf“ angegeben ist. Stellen Sie sicher, dass die entsprechenden Parameter korrekt sind. 

Schritt 2: Hinzufügen von Anfragekopfzeileninformationen beim direkten Hochladen von Dateien. Wenn Sie eine Datei direkt hochladen, müssen Sie die Informationen „Content-Type: application/pdf“ zu den Anfragekopfzeilen (Headers) hinzufügen, um den Typ der hochgeladenen Datei anzugeben und sicherzustellen, dass der direkte Datei-Upload reibungslos verläuft.

 

 

Welche Dateiformate werden vom openapi-Datei-Upload unterstützt?

Die folgenden Dateiformate werden unterstützt: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS Text (.wps), WPS Tabellen (.et), WPS Präsentation (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm) und CSV (.csv).

 

 

 

Beim Abfragen einer Dateisyntheseaufgabe über die taskId wird die Meldung „Dateikonvertierung fehlgeschlagen: Netzwerkadresse konnte nicht aufgerufen werden“ angezeigt.

Wenn bei der Dokumentkonvertierung ein Timeout auftritt, führt dies häufig dazu, dass die Dateisynthese fehlschlägt. In diesem Fall können Sie die Vorlage erneut aufrufen, um die Datei zu generieren, und anschließend die Schnittstelle zum Abfragen der Dateisyntheseaufgabe aufrufen, um zu überprüfen, ob die Dateisynthese erfolgreich war. Wenn die Dateisynthese nach den oben genannten Schritten immer noch fehlschlägt, können Sie sich direkt an das technische Personal wenden, das Ihnen bei der Lösung dieses Problems hilft.

 

 

Der Aufruf zum Abrufen der Datei-Upload-Adresse und der Parameter für den direkten Datei-Upload sind korrekt, aber der direkte Datei-Upload meldet immer noch "403 Forbidden: "<?xml version="1.0" encoding="UTF-8"?><EOL><Error><EOL> <Code>SignatureDoesNotMatch</Code><EOL> <Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message><EOL> <RequestId>68440537821143343409E1E9</RequestId><EOL>"

Wenn der Parameter in Schritt 1contentTypeÜbereinstimmend mit dem, was im Header in Schritt zwei übertragen wurdeContent-Typeübereinstimmt und durch den Aufruf von PostmanfileUploadUrldie direkte Dateiübertragung erfolgreich ist, aber beim Aufruf durch den Code weiterhin Fehler auftreten. Nach der Überprüfung der Parameter durch Haltepunkte wurde festgestellt, dass die Parameter korrekt übertragen werden. Möglicherweise liegt ein Kompatibilitätsproblem mit der Framework-Anwendung vor. Es wird empfohlen, sich auf die folgenden Codebeispiele für die direkte Dateiübertragung zu beziehen:

Referenzcode:

// 调用方式(以Java为例)
Response response = HttpUtil.sendRequest(
    "uploadUrl",                // 上传接口URL
    new File("文件路径/xxx.pdf"), // 待上传文件
    "application/pdf",          // 内容类型
    new HashMap<>()             // 可选请求头参数(若无则传空)
);

Wichtige Hinweise:

  1. Parameterkonsistenzprüfung: Stellen Sie sicher, dass im CodeContent-TypeParameter (wie"application/pdf") vollständig mit den Schnittstellenanforderungen übereinstimmen, einschließlich Groß- und Kleinschreibung und Format (wieapplication/jsonmuss strikt vonapplication/JSONunterschieden werden).
  2. Framework-Kompatibilitätsprüfung: Wenn die Codelogik korrekt ist, aber weiterhin Fehler auftreten, können Sie versuchen, das Kunden-Framework zu umgehen und direkt einen nativen HTTP-Client (wie Java'sURLConnection, Python'srequests) zu verwenden, um zu überprüfen, ob es sich um ein Kompatibilitätsproblem des Frameworks bei der Verarbeitung von Anfrageheadern und Dateistreams handelt.
  3. Fehlerprotokollierung: Es wird empfohlen, dass der Kunde vollständige Fehlermeldungen (wie HTTP-Statuscodes, vom Server zurückgegebene Nachrichten) erfasst und protokolliert, um die spezifische Fehlerursache auf Netzwerkebene oder Serverseite weiter zu untersuchen.

Diese Lösung standardisiert die Parameterübergabe und vereinfacht die Aufrufkette, wodurch Framework-Probleme effektiv isoliert und die Ursache für das Fehlschlagen der direkten Dateiübertragung schnell lokalisiert werden kann.