This tutorial shows how to merge documents using the LEADTOOLS Cloud Services in a Python application.
| Overview | |
|---|---|
| Summary | This tutorial covers how to make Merge requests and process the results using the LEADTOOLS Cloud Services in a Python application. |
| Completion Time | 30 minutes |
| Project | Download tutorial project (2 KB) |
| Platform | LEADTOOLS Cloud Services API |
| IDE | Visual Studio 2019 |
| Language | Python |
| Development License | Download LEADTOOLS |
| Try it in another language |
Be sure to review the following sites for information about LEADTOOLS Cloud Services API.
LEADTOOLS Service Plan offerings:
| Service Plan | Description |
|---|---|
| Free Trial | Free Evaluation |
| Page Packages | Prepaid Page Packs |
| Subscriptions | Prepaid Monthly Processed Pages |
To further explore the offerings, refer to Pricing Information for LEADTOOLS Hosted Cloud Services > Service Plan Terms.
For pricing details, refer to https://www.leadtools.com/sdk/products/hosted-services#pricing > Page Packages and Subscriptions.
To obtain the necessary Application ID and Application Password, refer to Create an Account and Application with the LEADTOOLS Hosted Cloud Services.
With the project created and the requests package added, coding can begin.
In the Solution Explorer, open Merge.py. Add the following variables at the top.
Note
Where it states
Replace with Application IDandReplace with Application Password, be sure to place your Application ID and Password accordingly.
# Simple script to showcasing how to use the Merge API in the LEADTOOLS Cloud Services.import requestsimport sysimport timeimport jsonfrom enum import EnumservicesUrl = "https://azure.leadtools.com/api/"# The application ID.appId = "Replace with Application ID"# The application password.password = "Replace with Application Password"# Conversion output formats.class FormatsEnum(Enum):Png = 1Jpeg = 2Tiff = 3Pdf = 4Pdfa = 5PdfImage = 6PdfImageOverText = 7PdfaImageOverText = 8Docx = 9DocxFramed = 10Rtf = 11RtfFramed = 12Txt = 13TxtFramed = 14
In order to facilitate the Merge request, create the following functions:
def upload_url_for_merge(fileUrl) - This submits a file at a Url to the server and returns a GUID.
def upload_file_for_merge(path) - This submits a local file to the server and returns a GUID.
def check_file_verification(id) - This will validate the file was submitted to the server via a provided GUID.
# Function to upload a file from a URL to the LEADTOOLS Cloud Services to be used with the Merge API command.def upload_url_for_merge(fileUrl):baseUploadUrl = '{}UploadFile?fileurl={}&forMerge=true'formattedUploadUrl = baseUploadUrl.format(servicesUrl, fileUrl)request = requests.post(formattedUploadUrl, auth=(appId, password))if request.status_code != 200:print("Error sending the upload request for file: " + fileUrl)print(request.text)sys.exit()return request.text# Function to upload a file to the LEADTOOLS Cloud Services to be used with the Merge API command.def upload_file_for_merge(path):baseUploadUrl ='{}UploadFile&forMerge=true'formattedUploadUrl = baseUploadUrl.format(servicesUrl)file = {'file' : open(path, 'rb')}request = requests.post(formattedUploadUrl, auth=(appId, password), files = file)if request.status_code != 200:print("Error sending the upload request for file: " + path)print(request.text)sys.exit()return request.text# Function to check if a file has passed the verification process.def check_file_verification(id):baseQueryUrl = '{}Query?id={}'formattedQueryUrl = baseQueryUrl.format(servicesUrl, id)returnedData = ""while True:request = requests.post(formattedQueryUrl, auth=(appId, password))returnedData = request.json()# We will check to make sure that the file has passed verification. For the full list of possible File Statuses, refer to our documentation here:# https://services.leadtools.com/documentation/api-reference/queryif returnedData['FileStatus'] != 123:breaktime.sleep(5)if returnedData['FileStatus'] != 122:print("The file has failed the verification process with File Status: " + returnedData['FileStatus'])return Falsereturn True
With the functions created, they can now be called and the files submitted and verified.
# We will be uploading the file via a URl. Files can also be passed by adding a PostFile to the request. Only 1 file will be accepted per request.# The Merge Api requires you to upload your files with the forMerge parameter set. A file that has been uploaded and tagged as forMerge is not compatible with other LEADTOOLS Cloud Services API functions.tiffFileURL = 'http://demo.leadtools.com/images/cloud_samples/ocr1-4.tif'firstFileId = upload_url_for_merge(tiffFileURL)print("First File ID: " + firstFileId)# At this point the file has been successfully uploaded to the LEADTOOLS Cloud Services and is undergoing verification. Before we continue, we need to make sure that the uploaded file has passed verificationif check_file_verification(firstFileId) == False:sys.exit()# We will now upload the second file we would like to mergepdfFileUrl = 'https://demo.leadtools.com/images/pdf/leadtools.pdf'secondFileId = upload_url_for_merge(pdfFileUrl)print("Second File ID: " + secondFileId)if check_file_verification(secondFileId) == False:sys.exit()
Once complete gather GUIDs from the two submitted files and other merge information, then process the Merge request.
This sends an Merge request to the LEADTOOLS Cloud Services API, if successful, a unique identifier (GUID) will be returned and then a query using this GUID will be made.
# We now need to create the JSON body response for the Merge Api Commanddata = []firstFileData = {}# pass every page in the filefirstFileData['firstPage'] = 1firstFileData['lastPage'] = -1firstFileData['fileId'] = firstFileIddata.append(firstFileData)secondFileData = {}# Make sure this file's pages are merged in a specific order.secondFileData['pages'] = [5,1,2,4,3]secondFileData['fileId'] = secondFileIddata.append(secondFileData)# The output format of the merged filesmergeFormat = FormatsEnum.Pdf.valuebaseMergeUrl = '{}Conversion/Merge?format={}'formattedMergeUrl = baseMergeUrl.format(servicesUrl, mergeFormat)request = requests.post(formattedMergeUrl, auth=(appId, password), json=data)if request.status_code != 200:print("Error sending merge request")print(request.text)sys.exit()
Next, create a Query request that utilizes the GUID provided by Merge request.
If successful, the response will contain all the request data in JSON format.
# At this point the merge request has been successfully received by the server, and is being processed.baseQueryUrl = '{}Query?id={}'formattedQueryUrl = baseQueryUrl.format(servicesUrl, firstFileId)# Poll the services to determine if the request has finished processingwhile True:request = requests.post(formattedQueryUrl, auth=(appId, password))returnedData = request.json()if returnedData['FileStatus'] != 100:breaktime.sleep(5)print("File finished processing with file status: " +str(returnedData['FileStatus']))if returnedData['FileStatus'] != 200:sys.exit()
Finally, parse the JSON data into a readable format.
try:print("Results:")returnedJson = returnedData['RequestData']for requestObject in returnedJson:print("Service Type: " + requestObject['ServiceType'])if requestObject['ServiceType'] == 'Conversion':print("Returned URLS:")for url in requestObject['urls']:print(url)except Exception as e:print("Failed to Parse JSON")print(e)
Run the project by pressing F5, or by selecting Debug -> Start Debugging.
If the steps were followed correctly, the console appears and the application displays the link to the merged file from the returned JSON data.

This tutorial showed how to merge files via the LEADTOOLS Cloud Services API.