DocuGenerate offre la possibilité de récupérer les documents générés au format binaire plutôt que de les stocker dans le cloud. En activant cette option lors de l’appel au point de terminaison generate document, vous pouvez obtenir la représentation binaire du document généré, qu’il soit au format PDF, Word, ou tout autre format de sortie spécifié.
Cette approche est particulièrement avantageuse pour des raisons de confidentialité, car les documents ne sont stockés nulle part dans le cloud. Ils vous sont livrés directement sous forme binaire. Pour recevoir la réponse binaire, assurez-vous de définir l’en-tête Accept de votre requête POST sur application/octet-stream. Cela indique à l’API de fournir le document binaire au lieu de la réponse JSON standard :
Accept: application/octet-stream
Voici un exemple d’obtention du document au format binaire lors du test de l’API avec Postman :
Une fois l’exécution réussie, la réponse du serveur inclura deux en-têtes supplémentaires :
Content-Disposition- Cet en-tête indique le nom de fichier du document généréX-Document-Id- Cet en-tête contient l’identifiant unique associé au document généré
Si le nom de fichier du document généré contient des caractères au-delà de la plage ASCII (caractères avec des codes de 0 à 127), à l’exception de ceux du Latin-1 Supplement (ISO 8859-1), le nom de fichier est alors encodé en URI lorsqu’il est renvoyé dans les en-têtes de la réponse. Dans ce cas, vous devez décoder l’URI du nom de fichier pour obtenir sa valeur d’origine. Assurez-vous de gérer correctement le décodage URI pour obtenir le nom de fichier exact.
Opter pour la récupération binaire améliore vos capacités de gestion de documents, garantissant à la fois efficacité et confidentialité dans votre processus de génération de documents.