Centro servizi

Gestione file

Errore durante l'aggiunta del file: fileKey non esistente, segnala "File cannot be found.

Verificare se, dopo aver utilizzato l'interfaccia per ottenere l'indirizzo del file, l'URL di caricamento del file ottenuto è stato utilizzato per caricare il flusso di file tramite HTTP PUT. Se non è stato caricato, chiamare l'URL per caricare il file.

 

Qual è la validità dell'indirizzo di caricamento del file?

Indirizzo di caricamento del file, linkLa validità della connessione è di 60 minuti.

 

 

Il sito di caricamento dei file durante l'integrazionehttps://file-sml.esignglobal.com/È particolarmente lento, il caricamento dei file è piuttosto lento

È necessario prestare attenzione al caricamento dei file nell'ambiente sandbox. Il suo server si trova a Singapore. Quando si accede direttamente dalla Cina, la rete è spesso instabile e si verificano occasionalmente problemi come blocchi, caricamenti lenti o impossibilità di accesso. In considerazione di ciò, si consiglia di accedere tramite un proxy di Singapore, il che contribuirà a migliorare l'instabilità della rete e a utilizzare più facilmente il servizio file.

 

 

Chiamata openapi per ottenere l'indirizzo del file con successo, quindi il caricamento del file non riesce

Passo 1: Ottenere l'indirizzo di caricamento del file Durante l'operazione, è necessario fornire le seguenti informazioni nel formato indicato per ottenere l'indirizzo di caricamento del file: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Si prega di notare che, sebbene il nome del file qui sia "fengniantest.pdf", il tipo di contenuto (contentType) è specificato come "application/pdf", è necessario assicurarsi che i parametri correlati siano accurati. 

Passo 2: Aggiungere le informazioni sull'intestazione della richiesta durante il caricamento diretto del file Quando si esegue un'operazione di caricamento diretto del file, è necessario aggiungere le informazioni 'Content-Type: application/pdf' all'intestazione (headers) per specificare il tipo di file caricato e garantire che l'operazione di caricamento diretto del file possa essere eseguita senza problemi.

 

 

Quali formati di file sono supportati dal caricamento di file openapi?

Sono supportati i seguenti formati di file: 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).

 

 

 

Tramite taskId, la query sull'attività di sintesi del file indica "Errore di conversione del file: accesso all'indirizzo di rete non riuscito"

Quando si verifica un timeout nella conversione del documento, spesso si verifica un errore nella sintesi del file. In questo caso, è possibile richiamare nuovamente il modello per generare il file, quindi richiamare l'interfaccia di query dell'attività di sintesi del file per verificare se la sintesi del file ha esito positivo. Se la sintesi del file continua a non riuscire dopo le operazioni di cui sopra, è possibile contattare direttamente il personale tecnico, che vi assisterà nella risoluzione del problema.

 

 

La chiamata per ottenere l'indirizzo di caricamento del file e i parametri di caricamento diretto del file sono corretti, ma il caricamento diretto del file segnala ancora "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 il parametro nel passaggio uno ècontentTypeCoerente con quello trasmesso nell'intestazione del passaggio dueContent-Typee richiamato tramite PostmanfileUploadUrlil caricamento diretto del file ha esito positivo, ma si verifica ancora un errore quando viene richiamato il codice. Dopo aver controllato il punto di interruzione, la trasmissione dei parametri è corretta, il che potrebbe essere un problema di compatibilità con l'applicazione del framework. Si consiglia di fare riferimento ai seguenti esempi di codice per il caricamento diretto dei file:

Codice di riferimento:

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

Note chiave:

  1. Verifica della coerenza dei parametri: assicurarsi che nel codiceContent-Typei parametri (come"application/pdf") siano completamente coerenti con i requisiti dell'interfaccia, inclusi maiuscole/minuscole e formato (comeapplication/jsondeve essere rigorosamente distinto daapplication/JSON).
  2. Risoluzione dei problemi di compatibilità del framework: se la logica del codice è corretta ma si verifica ancora un errore, è possibile provare a bypassare il framework del cliente e utilizzare direttamente un client HTTP nativo (come JavaURLConnection, Pythonrequests) per verificare se si tratta di un problema di compatibilità del framework con l'elaborazione delle intestazioni delle richieste e dei flussi di file.
  3. Individuazione dei log degli errori: si consiglia ai clienti di acquisire e registrare informazioni complete sugli errori (come il codice di stato HTTP, il messaggio di risposta del server) per indagare ulteriormente sulla causa specifica dell'errore a livello di rete o lato server.

Questa soluzione, standardizzando la trasmissione dei parametri e semplificando il percorso di chiamata, può isolare efficacemente i problemi del framework e individuare rapidamente la causa principale del fallimento del caricamento diretto del file.