getpublinkdownload

Name

getpublinkdownload

Auth

no

Description

Returns link(s) where the file can be downloaded

Expects as parameter code that can be either 'code' or 'shortcode'.

The code could be obtained from:

• getfilepublink - link to a single file
• getfolderpublink - link to a folder
• gettreepublink - link to a tree
• getcollectionpublink - link to a collection

If the link is to a folder also expects fileid.

Optional parameters

• forcedownload
• contenttype
• skipfilename
• maxspeed

work exaclty as explained in getfilelink.

This call is intentionally split from showpublink.

Getting download links for files you do not intend to download is considered bad behaviour.

getpublinkdownload is to be called when user intents to actually download the file.

URL

https://api.pcloud.com/getpublinkdownload

Required

Parameter	Description
code	string either 'code' or 'shortcode'
fileid	int File id, if the link is to a folder

Optional

Parameter	Description
forcedownload	int Download with 'Content-Type' = 'application/octet-stream'
contenttype	string Set 'Content-Type'
maxspeed	int limit the download speed
skipfilename	int include the name of the file in the generated link

Output

Returns link(s) where the file can be downloaded (same as getfilelink hosts, path and expire are returned).

Example

{
    result: 0,
    path: "/hash/My%20picture.jpg",
    expires: "Thu, 03 Oct 2013 01:06:49 +0000",
    hosts: [
        "c63.pcloud.com",
        "c1.pcloud.com"
    ]
}

Errors