Join Document Pages

Introduction

This REST API allows merging the source document with specific document pages from joined documents into one resultant document by specifying desired page numbers or page ranges. Joined documents should be of the same format. There are several ways to specify page numbers needed from each document:

  • Provide exact page numbers via Pages collection;
  • Specify pages range start/end page numbers. There is also an ability to get only even/odd pages from the specified page range by setting RangeMode property.

For protected documents, it is also required to provide a password. The table below contains the full list of properties that can be specified for each joined document.

NameDescriptionComment
FilePathThe file path in the storageRequired property
StorageNameStorage nameCould be omitted for default storage
VersionIdFile version IdUseful for storages that support file versioning
PasswordThe password to open fileShould be specified only for password-protected documents
PagesCollection of page numbers to use in a Join operationThe first page should have number 1
StartPageNumberStart page numberIgnored if Pages collection is not empty
EndPageNumberEnd page numberIgnored if Pages collection is not empty
RangeModePage range mode: Even, Odd, All. The default value is AllIgnored if Pages collection is not empty
OutputPathPath to resultant documentRequired

Resource URI


HTTP POST ~/join

Swagger UI lets you call this REST API directly from the browser.

cURL Example

* First get JSON Web Token
* Please get your Client Id and Client Secret from https://dashboard.groupdocs.cloud/applications. Kindly place Client Id in "client_id" and Client Secret in "client_secret" argument.
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx&client_secret=xxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

* cURL example to join pages from several documents into one document
curl -v "https://api.groupdocs.cloud/v1.0/merger/join" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer
<jwt token>"
-d "{
    'JoinItems':
    [
        {
            'FileInfo':
            {
                'FilePath': 'WordProcessing/sample-10-pages.docx'
            },
            'Pages':  [ 3, 6, 8 ],
        },
        {
            'FileInfo':
            {
                'FilePath': 'WordProcessing/four-pages.docx'
            },
            'StartPageNumber': 1,
            'EndPageNumber': 4,
            'RangeMode' : 1
        }
    ],
    'OutputPath': 'output/joined-pages.docx'
}"


*Response will contain storage path to resultant document
{
  "path": "output/joined-pages.docx"
}

SDKs

Using an SDK (API client) is the quickest way for a developer to speed up the development. An SDK takes care of a lot of low-level details of makingRequests and handlingResponses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of GroupDocs.Merger Cloud SDKs along with working examples, to get you started in no time. Please check the article to learn how to add an SDK to your project.

Join Document Pages