POST /v1/document/append

Request:

curl \
  -u username:password \
  -H "Content-Type: application/json" \
  --data "{
        \"documents\":[
          {
              \"document\": \"UEsDBBQAAAAIAAACAAC5EQAAAAA=\",
              \"documentDivider\": 1
          },
          {
              \"document\": \"UEsDBBQAAAAIAAACAAC5EQAAAAA=\",
              \"documentDivider\": 2
          }
      ],
      \"documentSettings\":{
          \"author\": \"Text Control GmbH\",
          \"creationDate\": null,
          \"creatorApplication\": null,
          \"documentSubject\": null,
          \"documentTitle\": null,
          \"lastModificationDate\": null,
          \"userPassword\": null
      }

  }" \
  -X POST "https://api.reporting.cloud/v1/document/append?returnFormat=PDF"

Results:

"JVBERi0xLjQNJeLjz9MNMSAwIG9iago8PAovVH..."

Request:

using System;
using System.Collections.Generic;
using System.Drawing;
using System.IO;
using TXTextControl.ReportingCloud;

class RCSamples
{
    public static void AppendDocuments(string documentName)
    {
        ReportingCloud rc = new ReportingCloud(
            "username",
            "password",
            new Uri("https://api.reporting.cloud"));

        try
        {
            // Append the document three times, each in a new section
            byte[] bDocument = File.ReadAllBytes(documentName);

            AppendBody appendBody = new AppendBody();

            for (int i = 0; i < 3; i++)
            {
                appendBody.Documents.Add(new AppendDocument()
                {
                    Document = bDocument,
                    DocumentDivider = DocumentDivider.NewSection
                });
            }

            appendBody.DocumentSettings = new DocumentSettings()
            {
                Author = "James Henry Trotter",
                DocumentTitle = "James and the Giant Peach"
            };

            byte[] bResults = rc.AppendDocument(appendBody, ReturnFormat.PDF);

            File.WriteAllBytes("appended.pdf", bResults);
            Console.WriteLine("Appended document written to appended.pdf.");
        }
        catch (Exception e)
        {
            Console.WriteLine("An error occurred: " + e.Message);
        }
    }
}

Results:

Appended document written to appended.pdf.

Request:

import com.textcontrol.reportingcloud.AppendBody;
import com.textcontrol.reportingcloud.AppendDocument;
import com.textcontrol.reportingcloud.DocumentDivider;
import com.textcontrol.reportingcloud.DocumentSettings;
import com.textcontrol.reportingcloud.ReportingCloud;
import com.textcontrol.reportingcloud.ReturnFormat;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.List;

public class ReportingCloudSample {
    public static void main(String[] args) throws IOException {
        byte[] documentData = Files.readAllBytes(Paths.get("test_document.docx"));

        List<AppendDocument> documents = new ArrayList<>();
        for (int i = 0; i < 3; i++) {
            documents.add(new AppendDocument(documentData, DocumentDivider.NewSection));
        }

        DocumentSettings documentSettings = new DocumentSettings();
        documentSettings.setAuthor("James Henry Trotter");
        documentSettings.setDocumentTitle("James and the Giant Peach");

        ReportingCloud r = new ReportingCloud("username", "password");
        byte[] pdfData = r.appendDocuments(new AppendBody(documents, documentSettings), ReturnFormat.PDF);

        String pdfFileName = "appended.pdf";
        Files.write(Paths.get(pdfFileName), pdfData);
        System.out.println("Appended document written to " + pdfFileName + ".");
    }
}

Results:

Appended document written to appended.pdf.

Request:

#!/usr/bin/env ruby

require "txtextcontrol/reportingcloud"
require "base64"

reporting_cloud = TXTextControl::ReportingCloud::ReportingCloud.new("username", "password")

document_data = File.open(File.dirname(__FILE__) + "/test_document.docx", "rb") { |f| f.read }
document_data_b64 = Base64.strict_encode64(document_data)

documents = Array.new(3) do
  TXTextControl::ReportingCloud::AppendDocument.new(document_data_b64, :new_section)
end

document_settings = TXTextControl::ReportingCloud::DocumentSettings.new
document_settings.author = "James Henry Trotter"
document_settings.document_title = "James and the Giant Peach"

append_body = TXTextControl::ReportingCloud::AppendBody.new(documents, document_settings)
append_result = reporting_cloud.append_documents(append_body)

pdf_file_name = "appended.pdf"
File.open(File.dirname(__FILE__) + "/#{pdf_file_name}", 'wb') do |f|
  f.write(Base64.strict_decode64(append_result))
end
puts "Appended document written to #{pdf_file_name}."

Results:

Appended document written to appended.pdf.

Request:

<?php

require_once __DIR__ . '/vendor/autoload.php';

use TextControl\ReportingCloud\ReportingCloud;

$reportingCloud = new ReportingCloud([
    'api_key' => (string) getenv('REPORTINGCLOUD_API_KEY'),
]);

$documents = [
    [
        'filename' => __DIR__ . '/test_document.docx',
        'divider'  => ReportingCloud::DOCUMENT_DIVIDER_NEW_SECTION,
    ],
    [
        'filename' => __DIR__ . '/test_document.docx',
        'divider'  => ReportingCloud::DOCUMENT_DIVIDER_NEW_SECTION,
    ],
    [
        'filename' => __DIR__ . '/test_document.docx',
        'divider'  => ReportingCloud::DOCUMENT_DIVIDER_NEW_SECTION,
    ],
];

$destinationFilename = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'test_append_document_advanced.pdf';

$documentSettings = [
    'author'                 => 'James Henry Trotter',
    'creation_date'          => time(),
    'creator_application'    => 'An awesome creator',
    'document_subject'       => 'The Old Green Grasshopper',
    'document_title'         => 'James and the Giant Peach',
    'last_modification_date' => time(),
    'user_password'          => '1',
];

$binaryData = $reportingCloud->appendDocument($documents, 'PDF', $documentSettings);

file_put_contents($destinationFilename, $binaryData);

var_dump($destinationFilename);

Results:

string(38) "/tmp/test_append_document_advanced.pdf"