Downloading Preview/Final
Obtaining PDF Final or Preview
This requires two calls - the first to build the PDF and the second to obtain the PDF data from the server for storage client-side.
1. Building the PDF
URL: /segments/remote_translate_pdf
Post Data: session_id, target_id, final
session_id
The unique key returned in the initial login call.
target_id
The value of target_lang_id obtained when the PDF was uploaded.
final
If False (the default, if not supplied) a PDF preview is generated. This will be uneditable and watermarked but is suitable for sending to clients as a proof-of-concept.
If True, the final version of the translated PDF is produced. This has no watermark or encryption and is suitable for editing in a PDF editor if needed to remedy any formatting issues. The user's credit balance will be adjusted to reflect the purchase. You can determine the cost in advance by calling remote_get_final_fee - see below.
Returns
On success, a JSON structure containing progress information.
On failure the HTTP status code will be set to something other than 200.
The JSON structure will contain amongst other things, the following fields:
task_id
The unique id of the task which corresponds to a separate thread on the server. Use this id to obtain status information about the task via the remote_task_status call.
2. Getting the PDF Data
URL: /segments/remote_download_pdf2
Post Data: session_id, target_id, final
session_id
The unique key returned in the initial login call.
target_id
The value of target_lang_id obtained when the PDF was uploaded.
final
If False (the default, if not supplied) a PDF preview is generated. This will be uneditable and watermarked but is suitable for sending to clients as a proof-of-concept.
If True, the final version of the translated PDF is produced. This has no watermark or encryption and is suitable for editing in a PDF editor if needed to remedy any formatting issues. The user's credit balance will be adjusted to reflect the purchase. You can determine the cost in advance by calling remote_get_final_fee - see below.
Returns
The name of the PDF file just downloaded is encoded into the HTTP header. The rest of the content is the file data itself.
An error is returned with an explanation if the user requests a 'final' version but does not have enough page credits for the purchase.