Téléverser un fichier

Procédure de téléchargement de fichiers

Étape 1 :Obtenir l'adresse de téléchargement du fichier . Utilisez l'URL de téléchargement de fichier obtenue via l'interface d'obtention de l'adresse de téléchargement direct de fichier.

Étape 2 :Télécharger le fichier . Utilisez l'URL obtenue à l'étape 1 pour télécharger le flux de fichiers via HTTP PUT.

【Attention】: Le contentType transmis à l'étape 1 doit être cohérent avec le Content-Type transmis dans l'en-tête de l'étape 2, sinon une erreur avec le code d'erreur 403 se produira.

【Attention】: contentMD5 n'est pas obligatoire. Si contentMD5 et contentType sont transmis à l'étape 1, Content-MD5 et Content-Type doivent également être transmis dans les en-têtes de l'étape 2 et rester cohérents.

Obtenir l'adresse de téléchargement du fichier

POST /esignglobal/v1/files/getUploadUrl

Description de l'interface

Obtenez l'adresse de téléchargement de fichier via cette interface

Paramètres de requête

Nom du paramètre	Type	Obligatoire	Explication
fileName	string	true	Nom du fichier 【Attention】 : Le nom doit inclure l'extension du fichier, sinon la création ultérieure de l'enveloppe ne pourra pas passer la validation. Exemple : Nom du contrat 1.pdf Remarques supplémentaires : （1）Le suffixe du nom de fichier de ce champ doit être cohérent avec le suffixe du fichier réel. Par exemple, si le type de fichier téléchargé est un fichier PDF, ce paramètre doit être transmis sous la forme « xxx.pdf », et non « xxx.docx ». （2）Le nom du fichier ne peut pas contenir les 9 caractères spéciaux suivants : /\:*"<>\|? ni aucune émoticône emoji （3）Seul le format de fichier .pdf est pris en charge
contentMD5	string	false	Valeur Content-MD5 du fichier Remarques supplémentaires : Vous devez d'abord obtenir le tableau binaire 128 bits du MD5 du fichier, puis encoder ce binaire en Base64. 【Attention】Si la valeur de ce paramètre est transmise, la valeur Content-MD5 du fichier téléchargé à l'étape 2 doit également être la même
contentType	string	true	Type de contenu 【Attention】Le Content-Type du fichier téléchargé à l'étape 2 doit également être le même

Exemple de requête

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

Paramètres de réponse

Nom du paramètre	Type	Description
fileKey	string	Clé de fichier fileKey
fileName	string	Nom du fichier
fileUploadUrl	string	Adresse de téléversement du fichier, valide pendant 60 minutes 【Attention】 Veuillez demander à nouveau l'interface pour obtenir l'adresse de téléversement après l'expiration.

Exemple de réponse

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

Téléverser un fichier

L'URL de téléversement de fichier obtenue via l'interface "Obtenir l'adresse de téléversement de fichier".

Description de l'interface

Utilisez la méthode de requête PUT pour téléverser le flux de fichiers (flux d'octets binaires) vers le serveur via l'URL de téléversement de fichier (adresse de téléversement de fichier) déjà obtenue.

Paramètres de la requête

1. En-têtes

Nom du paramètre

Type

Obligatoire

Description

Content-MD5

string

false

Identique à la valeur contentMD5 dans le corps de la 【Obtenir l'adresse de téléchargement du fichier】

Content-Type

string

true

Type MIME du fichier cible

Remarques supplémentaires :

Peut être rempli avec application/octet-stream ou application/pdf, doit être cohérent avec les paramètres de requête de l'interface d'obtention de l'adresse de téléchargement

2. CORPS HTTP :Flux d'octets binaires du fichier à télécharger

3. Méthode d'encodage :

Exemple de requête

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

Exemple de réponse

http_status: 200