DocuGenerate biedt de flexibiliteit om de gegenereerde documenten in binair formaat te ontvangen in plaats van ze op te slaan in de cloud. Door deze optie in te schakelen bij het aanroepen van het eindpunt generate document, kunt u de binaire weergave van het gegenereerde document verkrijgen, of het nu in PDF, Word of een ander opgegeven uitvoerformaat is.
Deze aanpak is vooral voordelig om privacyredenen, aangezien documenten nergens in de cloud worden opgeslagen. In plaats daarvan worden ze rechtstreeks in binaire vorm aan u geleverd. Om het binaire antwoord te ontvangen, moet u ervoor zorgen dat u de Accept-header van uw POST-verzoek instelt op application/octet-stream. Dit geeft de API het signaal om het binaire document te leveren in plaats van het standaard JSON-antwoord:
Accept: application/octet-stream
Hier is een voorbeeld van het verkrijgen van het document in binair formaat bij het testen van de API met Postman:
Bij succesvolle uitvoering bevat het antwoord van de server twee extra headers:
Content-Disposition- Deze header geeft de bestandsnaam van het gegenereerde document opX-Document-Id- Deze header bevat de unieke ID die is gekoppeld aan het gegenereerde document
Als de bestandsnaam van het gegenereerde document tekens bevat buiten het ASCII-bereik (tekens met codes 0 tot 127), met uitzondering van die uit de Latin-1 Supplement (ISO 8859-1), dan wordt de bestandsnaam URI-gecodeerd wanneer deze wordt geretourneerd in de antwoordheaders. In dat geval moet u de bestandsnaam URI-decoderen om de oorspronkelijke waarde te verkrijgen. Zorg ervoor dat u de URI-decodering op de juiste manier verwerkt om de correcte bestandsnaam te verkrijgen.
Kiezen voor binaire ophaling verbetert uw mogelijkheden voor documentverwerking, en zorgt voor zowel efficiëntie als privacy in uw documentgeneratieproces.