Téléverser des fichiers sur le serveur

Téléversez des images sur le serveur ABBYY FlexiCapture via la Mobile API à l’aide de requêtes PUT ou POST, avec vérification du hachage MD5 et prise en charge du multipart.

Pour téléverser un fichier sur le serveur, utilisez une requête PUT ou POST.

​

Créer une requête PUT

Pour téléverser un fichier à l’aide d’une requête PUT, utilisez l’URI suivante :

https://localhost/flexicapture12/server/MobileApp?filename=[file name]&projectName=[project name]&batchType=[batch name]

L’URI accepte les paramètres suivants :

Paramètre	Description
projectName	Le nom du projet. Obligatoire.
batchType	Le nom du batch. Obligatoire. Si aucune valeur n’est spécifiée, le type de batch par défaut est utilisé.
filename	Le nom du fichier à téléverser. Obligatoire.

Vous ne pouvez pas transmettre de paramètres d’enregistrement dans une requête PUT. Pour plus d’informations, consultez Spécifier la structure d’un batch.

Spécifiez explicitement la valeur du champ d’en-tête Content-type et placez le fichier à téléverser dans le corps de la requête PUT.

Le serveur prend également en charge le hachage. Encodez la valeur de hachage MD5 du fichier en Base64 avec UTF-16LE, puis transmettez-la dans l’en-tête standard Content-MD5.

Le serveur calcule sa propre valeur de hachage pour le fichier et la compare à celle de l’en-tête. Si les deux valeurs ne correspondent pas, le serveur supprime le fichier.

Deux réponses du serveur sont possibles :

• HTTP 201 (Created) – Le fichier a été téléversé vers le serveur avec succès.
• HTTP 400 (Bad request) – Un paramètre obligatoire est manquant, ou la valeur de la fonction de hachage ne correspond pas à celle spécifiée dans l’en-tête. Aucun fichier n’a été téléversé.

​

Créer une requête POST

Utilisez une requête PUT lorsque c’est possible. Si PUT n’est pas une option, téléversez plutôt le fichier à l’aide d’une requête POST. Transmettez les paramètres projectName et batchType dans l’URL, comme dans une requête PUT, ou sous forme de champs de texte dans le corps de la requête.

​

Transmettre plusieurs images dans une requête

Vous pouvez transmettre plusieurs images dans une seule requête POST. Définissez la valeur du champ Content-type sur multipart/form-data et indiquez la valeur du séparateur dans le paramètre limite. Les noms des fichiers inclus dans une requête ne doivent pas être identiques.

L’exemple suivant transmet deux fichiers dans une seule requête :

Content-type: multipart/form-data; boundary=<random string>
--<boundary value>
Content-Disposition: form-data; name=<field name>; filename=<name of file 1><crlf>
Content-MD5: <value of MD5 hash for file><crlf>
<crlf>
<file data>
--<boundary value>
Content-Disposition: form-data; name=<field name>; filename=<name of file 2><crlf>
<crlf>
<file data>

​

Transmettre un champ Text

Vous pouvez également transmettre un champ Text dans une requête POST :

--<boundary value>
Content-Disposition: form-data; name="<field name>"<crlf>
<crlf>
<field value><crlf>

Terminez la requête par cette chaîne limite :

--<boundary value>--<crlf><crlf>