Centro de servicio

Administración de archivos

Error al agregar el archivo, la clave del archivo no existe, informa “File cannot be found.

Verifique si después de usar la interfaz para obtener la dirección del archivo para obtener la URL de carga del archivo, ha utilizado la URL obtenida para cargar el flujo de archivos mediante HTTP PUT. Si no ha cargado, llame a la URL para cargar el archivo.

 

¿Cuál es el período de validez de la dirección de carga del archivo?

Dirección de carga del archivo, enlaceEl período de validez de la conexión es de 60 minutos.

 

 

El sitio para cargar archivos durante el proceso de conexiónhttps://file-sml.esignglobal.com/Es muy lento, la carga de archivos es relativamente lenta

Se debe prestar atención a la carga de archivos en el entorno sandbox. Su servidor está ubicado en Singapur. Cuando se accede directamente desde China, la red a menudo es inestable y ocurren problemas como retrasos, carga lenta o imposibilidad de acceso. En vista de esto, se recomienda acceder a través de un proxy en Singapur, lo que ayudará a mejorar la inestabilidad de la red y facilitará el uso de este servicio de archivos.

 

 

Falla la carga del archivo después de que la llamada openapi para obtener la dirección del archivo sea exitosa

Paso uno: Obtener la dirección de carga de archivos Durante la operación, debe proporcionar la siguiente información para obtener la dirección de carga de archivos: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Tenga en cuenta que, aunque el nombre del archivo aquí es "fengniantest.pdf", el tipo de contenido (contentType) se especifica como "application/pdf", y debe asegurarse de que los parámetros relevantes sean precisos. 

Paso dos: Agregar información de encabezado de solicitud al cargar archivos directamente Al realizar la operación de carga directa de archivos, debe agregar la información 'Content-Type: application/pdf' al encabezado (headers) para especificar el tipo de archivo cargado y garantizar que la operación de carga directa de archivos se pueda realizar sin problemas.

 

 

¿Qué formatos de archivo admite la carga de archivos openapi?

Se admiten los siguientes formatos de archivo: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS文字 (.wps), WPS表格 (.et), WPS演示 (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm) y formato CSV (.csv).

 

 

 

Al consultar la tarea de síntesis de archivos a través de taskId, aparece el mensaje "Error en la conversión de archivos: Error al acceder a la dirección de red"

Cuando se produce un tiempo de espera en la conversión de documentos, a menudo provoca un error en la síntesis de archivos. En este momento, puede volver a llamar a la plantilla para generar el archivo y, a continuación, llamar a la interfaz de consulta de tareas de síntesis de archivos para ver si la síntesis de archivos se ha realizado correctamente. Si la síntesis de archivos sigue fallando después de la operación anterior, puede ponerse en contacto directamente con el personal técnico para que le ayude a resolver este problema.

 

 

La llamada para obtener la dirección de carga de archivos y los parámetros de carga directa de archivos son correctos, pero la carga directa de archivos sigue informando "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>"

Si el parámetro de la etapa uno escontentTypeCoincide con el transmitido en el encabezado del paso dosContent-Typey se invoca a través de PostmanfileUploadUrlLa carga directa del archivo es exitosa, pero el código sigue informando un error al invocarlo. Después de verificar el punto de interrupción, la transmisión de parámetros es correcta, lo que puede deberse a un problema de compatibilidad con la aplicación del framework. Se recomienda consultar el siguiente ejemplo de código para la carga directa de archivos:

Código de referencia:

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

Notas clave:

  1. Verificación de la consistencia de los parámetros: asegúrese de que en el códigoContent-Typelos parámetros (como"application/pdf") sean completamente consistentes con los requisitos de la interfaz, incluyendo mayúsculas y minúsculas, y el formato (comoapplication/jsondebe distinguirse estrictamente deapplication/JSON).
  2. Solución de problemas de compatibilidad del framework: si la lógica del código es correcta pero aún informa un error, puede intentar omitir el framework del cliente y usar directamente un cliente HTTP nativo (comoURLConnectionde Java, orequestsde Python) para verificar si hay un problema de compatibilidad en el procesamiento de encabezados de solicitud y flujos de archivos por parte del framework.
  3. Localización de registros de errores: se recomienda que el cliente capture y registre la información completa del error (como el código de estado HTTP, el mensaje de respuesta del servidor) para investigar más a fondo la causa específica del error en la capa de red o en el lado del servidor.

Esta solución, al estandarizar la transmisión de parámetros y simplificar la ruta de invocación, puede aislar eficazmente los problemas del framework y localizar rápidamente la causa raíz del fallo en la carga directa de archivos.