Create a view URL

With this API call you can create a view link for the PROOFSCOPE viewer.

api.proofscope.create_view_file_url_with_options(host_url, file_url, options)

Parameters:
  • host_url: the public host URL where CLOUDFLOW is accessible (for example http://my.company.com/).
  • file_url: the CLOUDFLOW URL of the asset to view (for example cloudflow://PP_FILE_STORE/viewable%20files/afile.pdf).
  • options: a JSON dictionary with optional parameters.
    • email: the email of the user that will view the file.
    • time_out: the amount of seconds the link should be available, by default 14 days.
Note: This call just returns an URL, it doesn't send an email to the user. If the contact doesn't exist, it will be created on the fly.

Example

If you want to view the asset cloudflow://PP_FILE_STORE/Demo%20Files/Cakepops_NEW.pdf, and if you want to make it available for the user with e-mail: john@…

the API call:

api.proofscope.create_view_file_url_with_options(
 "http://localhost:9090", 
 "cloudflow://PP_FILE_STORE/Demo%20Files/Cakepops_NEW.pdf", {
 email: "john@domain.com"
})

returns:

{ 
 "result": "ok",
 "url": "http://localhost:9090/portal.cgi?proofscope&asset_id=553a171ce7c40000000004a1&email=john%40domain.com&temp_scope=1471c75d-b153-4b0d-90a6-cd8284447605&signature=82aea0510f246eff788a77dbdf7f70b3"
}