Carica file

Passaggi per caricare un file

Passaggio 1:Ottieni l'indirizzo di caricamento del file. Utilizzare l'URL di caricamento diretto del file ottenuto tramite l'interfaccia per ottenere l'indirizzo di caricamento diretto del file.

Passaggio 2:Carica il file. Caricare il flusso di file utilizzando il metodo HTTP PUT tramite l'URL ottenuto nel passaggio 1.

【Attenzione】: il contentType trasmesso nel passaggio 1 deve essere coerente con il Content-Type trasmesso nell'intestazione nel passaggio 2, altrimenti si verificherà un errore con codice 403.

【Attenzione】: contentMD5 non è un campo obbligatorio. Se contentMD5 e contentType vengono trasmessi tramite il passaggio 1, Content-MD5 e Content-Type devono essere trasmessi anche nelle intestazioni del passaggio 2 e devono rimanere coerenti

Ottieni l'indirizzo di caricamento del file

POST /esignglobal/v1/files/getUploadUrl

Descrizione dell'interfaccia

Ottieni l'indirizzo di caricamento del file tramite questa interfaccia

Parametri di richiesta

Nome del parametro	Tipo	Obbligatorio	Descrizione
fileName	string	true	Nome del file 【Attenzione】: Deve includere l'estensione del file, altrimenti la successiva creazione della busta non supererà la verifica. Esempio: NomeContratto1.pdf Note aggiuntive: （1）Il suffisso del nome del file in questo campo deve essere coerente con il suffisso del file reale. Ad esempio, se il tipo di file caricato è un file PDF, questo parametro deve essere trasmesso come "xxx.pdf", non "xxx.docx". （2）Il nome del file non può contenere i seguenti 9 caratteri speciali: /\:*"<>\|? e tutte le emoji （3）Supporta solo il formato di file .pdf
contentMD5	string	false	Valore Content-MD5 del file Note aggiuntive: È necessario prima ottenere l'array binario a 128 bit dell'MD5 del file, quindi codificare questo binario in Base64. 【Attenzione】Se viene trasmesso il valore di questo parametro, è necessario trasmettere lo stesso valore anche per il Content-MD5 del file caricato nella fase due
contentType	string	true	Tipo di contenuto 【Attenzione】È necessario trasmettere lo stesso valore anche per il Content-Type del file caricato nella fase due

Esempio di richiesta

{
  "fileName": "测试.pdf",
  "contentType": "application/pdf"
}

Parametri di risposta

Nome parametro	Tipo	Descrizione
fileKey	string	File fileKey
fileName	string	Nome del file
fileUploadUrl	string	Indirizzo di caricamento del file, valido per 60 minuti 【Attenzione】 Si prega di richiedere nuovamente l'interfaccia per ottenere l'indirizzo di caricamento dopo la scadenza

Esempio di risposta

{
    "code": "0",
    "data": {
    "fileKey": "xxxxxxxxx",
      "fileName": "签署.pdf",
      "fileUploadUrl": "文件上传地址"
  },
  "message": "成功"
}

Carica file

L'URL di caricamento del file ottenuto tramite l'interfaccia "Ottieni indirizzo di caricamento del file".

Descrizione dell'interfaccia

Tramite l'URL di caricamento del file (indirizzo di caricamento del file) già ottenuto, utilizzare il metodo di richiesta PUT per caricare il flusso di file (flusso di byte binari) sul server.

Parametri di richiesta

1. Intestazioni

Nome parametro

Tipo

Obbligatorio

Descrizione

Content-MD5

string

false

Coerente con il valore contentMD5 nel corpo della 【Richiesta indirizzo di caricamento file】

Content-Type

string

true

Tipo MIME del file di destinazione

Note aggiuntive:

Può essere compilato con application/octet-stream o application/pdf, deve essere coerente con i parametri di richiesta dell'interfaccia di acquisizione dell'indirizzo di caricamento

2. CORPO HTTP:Flusso di byte binari del file da caricare

3. Metodo di codifica:

Esempio di richiesta

fileName = URLEncoder.encode(fileName, "UTF-8");
// replace special characters
fileName = fileName
  .replaceAll("\\+", "%20")
  .replaceAll("%28", "(")
  .replaceAll("%29", ")")
  .replaceAll("%27", "'")
  .replaceAll("%21", "!")
  .replaceAll("%7E", "~");

Esempio di risposta

http_status: 200