Central de Atendimento
Home

Gestão de ficheiros

Erro ao adicionar ficheiro: fileKey não existe, reporta “File cannot be found.”

Verifique se, após usar a interface para obter o endereço do ficheiro, usou o URL de upload do ficheiro obtido para carregar o fluxo de ficheiro usando o método HTTP PUT. Se não carregou, chame o URL para carregar o ficheiro.

 

Qual é o período de validade do endereço de upload do ficheiro?

Endereço de upload do ficheiro, linkO período de validade da ligação é de 60 minutos.

 

 

O site de upload de ficheiros durante a integraçãohttps://file-sml.esignglobal.com/É muito lento, o upload de ficheiros é relativamente lento

Ao integrar e carregar ficheiros no ambiente sandbox, deve-se notar que o seu servidor está localizado em Singapura. Quando acedido diretamente na China, a rede é frequentemente instável, e problemas como lentidão, carregamento lento ou inacessibilidade ocorrem de tempos em tempos. Tendo isto em conta, recomenda-se o acesso através de um proxy de Singapura, o que ajudará a melhorar a instabilidade da rede e a usar este serviço de ficheiros de forma mais conveniente.

 

 

Falha no upload do ficheiro após o sucesso da chamada openapi para obter o endereço do ficheiro

Passo 1: Obter o endereço de carregamento de ficheiros Durante a operação, é necessário fornecer as informações relevantes no seguinte formato para obter o endereço de carregamento de ficheiros: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Note que, embora o nome do ficheiro aqui seja "fengniantest.pdf", o tipo de conteúdo (contentType) é especificado como "application/pdf", e é necessário garantir que os parâmetros relevantes estejam corretos. 

Passo 2: Adicionar informações de cabeçalho de pedido ao carregar ficheiros diretamente Ao realizar a operação de carregamento direto de ficheiros, é necessário adicionar as informações 'Content-Type: application/pdf' ao cabeçalho (headers) para especificar o tipo de ficheiro carregado e garantir que a operação de carregamento direto de ficheiros possa ser realizada sem problemas.

 

 

Quais formatos de ficheiro são suportados pelo carregamento de ficheiros openapi?

São suportados os seguintes formatos de ficheiro: 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) e CSV (.csv).

 

 

 

Ao consultar a tarefa de síntese de ficheiros através do taskId, aparece a mensagem “Falha na conversão do ficheiro: falha no acesso ao endereço de rede”

Quando ocorre um tempo limite de conversão de documentos, muitas vezes leva à falha na síntese do ficheiro. Neste momento, pode voltar a chamar o modelo para gerar o ficheiro e, em seguida, chamar a interface de consulta da tarefa de síntese de ficheiros para verificar se a síntese do ficheiro foi bem-sucedida. Se a síntese do ficheiro ainda falhar após as operações acima, pode contactar diretamente o pessoal técnico para o ajudar a resolver este problema.

 

 

A chamada para obter o endereço de carregamento de ficheiros e os parâmetros de carregamento direto de ficheiros estão corretos, mas o carregamento direto de ficheiros ainda reporta "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>"

Se o parâmetro transmitido no passo 1 forcontentTypeConsistente com o transmitido no Header do passo doisContent-Typee invocado através do PostmanfileUploadUrlo carregamento direto do ficheiro é bem-sucedido, mas o código continua a apresentar erros quando invocado. Após verificar o ponto de interrupção, a transmissão de parâmetros está correta, podendo existir problemas de compatibilidade na aplicação da framework. Recomenda-se consultar os seguintes exemplos de código para o carregamento direto de ficheiros:

Código de referência:

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

Notas importantes:

  1. Verificação da consistência dos parâmetros: Certifique-se de que os parâmetros no códigoContent-Typeparâmetros (como"application/pdf") são totalmente consistentes com os requisitos da interface, incluindo maiúsculas e minúsculas e formato (comoapplication/jsondeve ser rigorosamente distinguido deapplication/JSON).
  2. Resolução de problemas de compatibilidade da framework: Se a lógica do código estiver correta, mas ainda apresentar erros, pode tentar contornar a framework do cliente e usar diretamente um cliente HTTP nativo (como oURLConnectiondo Java, orequestsdo Python) para verificar se existe um problema de compatibilidade da framework no processamento de cabeçalhos de pedido e fluxos de ficheiros.
  3. Localização de registos de erros: Recomenda-se que o cliente capture e registe informações de erro completas (como o código de estado HTTP, a mensagem de resposta do servidor) para investigar mais a fundo a causa específica do erro na camada de rede ou no lado do servidor.

Esta solução, através da padronização da transmissão de parâmetros e da simplificação do caminho de invocação, pode isolar eficazmente os problemas da framework e localizar rapidamente a causa raiz da falha no carregamento direto de ficheiros.

    Link: