Сервисный центр
Home

Управление файлами

Ошибка добавления файла: fileKey не существует, сообщение об ошибке “File cannot be found.”

Пожалуйста, проверьте, использовали ли вы URL-адрес fileUpload, полученный с помощью интерфейса получения адреса файла, для загрузки потока файлов с помощью HTTP PUT. Если загрузка не была выполнена, вызовите URL-адрес для загрузки файла.

 

Какой срок действия у адреса для загрузки файла?

Адрес для загрузки файла, ссылкаСрок действия ссылки 60 минут.

 

 

Во время интеграции сайт загрузки файловhttps://file-sml.esignglobal.com/Очень медленный, загрузка файлов происходит медленно

При интеграции загрузки файлов в среде песочницы следует учитывать, что ее сервер расположен в Сингапуре, и при прямом доступе из Китая сеть часто бывает нестабильной, время от времени возникают такие проблемы, как зависания, медленная загрузка или невозможность доступа. В связи с этим рекомендуется получать доступ через прокси-сервер в Сингапуре, что поможет улучшить нестабильность сети и упростить использование этой файловой службы.

 

 

Сбой загрузки файла после успешного получения адреса файла через openapi

Шаг 1: Получение адреса для загрузки файла. В процессе работы необходимо предоставить следующую информацию в указанном формате, чтобы получить адрес для загрузки файла: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" }. Обратите внимание, что хотя имя файла здесь указано как «fengniantest.pdf», тип содержимого (contentType) указан как «application/pdf», поэтому необходимо убедиться в точности соответствующих параметров. 

Шаг 2: Добавление информации заголовка запроса при прямой передаче файла. При выполнении прямой передачи файла необходимо добавить информацию «Content-Type: application/pdf» в заголовки (headers), чтобы указать тип загружаемого файла и обеспечить успешное выполнение прямой передачи файла.

 

 

Какие форматы файлов поддерживает загрузка файлов OpenAPI?

Поддерживаются следующие форматы файлов: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS Writer (.wps), WPS Spreadsheet (.et), WPS Presentation (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm) и CSV (.csv).

 

 

 

При запросе задачи синтеза файла по taskId появляется сообщение «Ошибка преобразования файла: не удалось получить доступ к сетевому адресу»

Когда происходит тайм-аут преобразования документа, это часто приводит к сбою синтеза файла. В этом случае вы можете повторно вызвать шаблон для создания файла, а затем вызвать интерфейс запроса задачи синтеза файла, чтобы проверить, успешно ли выполнен синтез файла на этот раз. Если после вышеуказанных операций синтез файла по-прежнему не удался, вы можете напрямую связаться с техническим персоналом, чтобы профессиональные технические специалисты помогли вам решить эту проблему.

 

 

Вызов для получения адреса загрузки файла и параметров прямой передачи файла выполнен правильно, но прямая передача файла по-прежнему сообщает об ошибке "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>"

Если в шаге 1 передаваемый параметрcontentTypeСоответствует переданному в заголовке шага 2Content-Typeи успешно вызывается через PostmanfileUploadUrlПрямая загрузка файла прошла успешно, но при вызове из кода по-прежнему возникает ошибка. После проверки параметров в режиме отладки выяснилось, что передача параметров верна. Возможно, существует проблема совместимости с приложением фреймворка. Рекомендуется обратиться к следующему примеру кода для прямой загрузки файла:

Пример кода:

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

Ключевые пояснения:

  1. Проверка согласованности параметров: убедитесь, что в кодеContent-Typeпараметры (например,"application/pdf") полностью соответствуют требованиям интерфейса, включая регистр и формат (например,application/jsonдолжен строго отличаться отapplication/JSON).
  2. Устранение проблем совместимости фреймворка: если логика кода верна, но по-прежнему возникает ошибка, можно попробовать обойти клиентский фреймворк и использовать собственный HTTP-клиент (например,URLConnectionв Java, илиrequestsв Python) для проверки, чтобы определить, является ли это проблемой совместимости обработки заголовков запросов и потоков файлов фреймворком.
  3. Определение местоположения ошибок в журналах: рекомендуется клиенту перехватывать и записывать полную информацию об ошибках (например, код состояния HTTP, сообщение, возвращаемое сервером), чтобы в дальнейшем устранить конкретную причину ошибки на сетевом уровне или на стороне сервера.

Это решение позволяет эффективно изолировать проблемы фреймворка и быстро определить причину сбоя прямой загрузки файла за счет стандартизации передачи параметров и упрощения цепочки вызовов.

    Ссылка: