DocuGenerate bietet die Möglichkeit, generierte Dokumente im Binärformat zu erhalten, anstatt sie in der Cloud zu speichern. Indem Sie diese Option beim Aufruf des Dokument generieren-Endpunkts aktivieren, erhalten Sie die binäre Darstellung des generierten Dokuments, egal ob es sich um ein PDF, Word oder ein anderes angegebenes Ausgabeformat handelt.
Dieser Ansatz ist besonders vorteilhaft aus Datenschutzgründen, da Dokumente nirgendwo in der Cloud gespeichert werden. Stattdessen werden sie direkt in binärer Form an Sie übermittelt. Um die binäre Antwort zu erhalten, stellen Sie sicher, dass Sie den Accept-Header Ihrer POST-Anfrage auf application/octet-stream setzen. Dies signalisiert der API, das binäre Dokument anstelle der Standard-JSON-Antwort bereitzustellen:
Accept: application/octet-stream
Hier ist ein Beispiel, wie Sie das Dokument im Binärformat erhalten, wenn Sie die API mit Postman testen:
Bei erfolgreicher Ausführung enthält die Server-Antwort zwei zusätzliche Header:
Content-Disposition– Dieser Header gibt den Dateinamen des generierten Dokuments anX-Document-Id– Dieser Header enthält die eindeutige ID des generierten Dokuments
Wenn der Dateiname des generierten Dokuments Zeichen außerhalb des ASCII-Bereichs (Zeichen mit Codes 0 bis 127) enthält, ausgenommen jene aus dem Latin-1-Supplement (ISO 8859-1), wird der Dateiname URI-kodiert in den Antwort-Headern zurückgegeben. In diesem Fall müssen Sie den Dateinamen URI-dekodieren, um seinen ursprünglichen Wert zu erhalten. Stellen Sie sicher, dass Sie die URI-Dekodierung entsprechend handhaben, um den korrekten Dateinamen zu erhalten.
Die Wahl des binären Empfangs verbessert Ihre Dokument-Verarbeitungsmöglichkeiten und gewährleistet sowohl Effizienz als auch Datenschutz in Ihrem Dokumentgenerierungsprozess.