header

Magento 1.x Software Support Notice

For Magento Commerce 1, Magento is providing software support through June 2020. Depending on your Magento Commerce 1 version, software support may include both quality fixes and security patches. Please review our Magento Software Lifecycle Policy to see how your version of Magento Commerce 1 is supported.

For Magento Open Source 1.5 to 1.9, Magento is providing software security patches through June 2020 to ensure those sites remain secure and compliant. Visit our information page for more details about our software maintenance policy and other considerations for your business.

Downloadable Link List

Edit this page on GitHub

Module: Complex Product API

Resource: product_downloadable_link

Method:

Allows you to retrieve a list of links of a downloadable product.

Arguments:

Type Name Description
string sessionId Session ID
string productId Product ID or SKU
string store Store view ID or code (optional)
string identifierType Defines whether the product ID or SKU is passed in the request

Return:

Type Name Description
array result Array of catalogProductDownloadableLinkListEntity

The catalogProductDownloadableLinkListEntity content is as follows:

Type Name Description
array links Array of catalogProductDownloadableLinkEntity
array samples Array of catalogProductDownloadableLinkSampleEntity

The catalogProductDownloadableLinkEntity content is as follows:

Type Name Description
string link_id
Link ID
string title
Link title
string price
Downloadable link price value 
int number_of_downloads
Maximum number of possible downloads
int is_unlimited
Defines whether the number of downloads is unlimited
int is_shareable
Defines whether the link is shareable
string link_url
Link URL address
string link_type
Type of the link data source. Can have one of the following values: "file" or "url"
string sample_file
Sample file name
string sample_url
Sample URL
string sample_type
Type of sample data source. Can have one of the following values: "file" or "url"
int sort_order
Link sort order
array file_save
Array of catalogProductDownloadableLinkFileInfoEntity
array sample_file_save
Array of catalogProductDownloadableLinkFileInfoEntity

The catalogProductDownloadableLinkSampleEntity content is as follows:

Type Name Description
string sample_id
Sample ID
string
product_id
Product ID
string
sample_file
Sample file name
string
sample_url
Sample URL
string
sample_type
Sample type. Can have one of the following values: "file" or "url"
string
sort_order
Sort order
string
default_title
Default title
string
store_title
Store title
string
title
Sample title

The catalogProductDownloadableLinkFileInfoEntity content is as follows:

Type Name Description
string file
File
string name
File name
int size
File size
string status
Status

Faults:
No Faults

Examples

Request Example SOAP V1
$proxy = new SoapClient('http://magentohost/api/soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');

$downloadableProductId = '5';

$resultList = $proxy->call(
    $sessionId,
    'product_downloadable_link.list',
    array($downloadableProductId)
);
Request Example SOAP V2
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl'); // TODO : change url
$sessionId = $proxy->login('apiUser', 'apiKey'); // TODO : change login and pwd if necessary

$result = $proxy->catalogProductDownloadableLinkList($sessionId, '5', null, 'sku');
var_dump($result);
Request Example SOAP V2 (WS-I Compliance Mode)
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl');

$sessionId = $proxy->login((object)array('username' => 'apiUser', 'apiKey' => 'apiKey'));

$result = $proxy->catalogProductDownloadableLinkList((object)array('sessionId' => $sessionId->result, 'productId' => '5'));

var_dump($result->result);
Response Example SOAP V1
array
  'links' =>
    array
      0 =>
        array
          'link_id' => string '1' (length=1)
          'title' => string 'link 1' (length=11)
          'price' => string '30.0000' (length=7)
          'number_of_downloads' => string '0' (length=1)
          'is_shareable' => string '1' (length=1)
          'link_url' => null
          'link_type' => string 'file' (length=4)
          'sample_file' => string '/s/o/software.jpg' (length=17)
          'sample_url' => null
          'sample_type' => string 'file' (length=4)
          'sort_order' => string '1' (length=1)
          'file_save' =>
            array
              ...
          'sample_file_save' =>
            array
              ...
          'is_unlimited' => int 1
  'samples' =>
    array
      0 =>
        array
          'sample_id' => string '1' (length=1)
          'product_id' => string '5' (length=1)
          'sample_url' => null
          'sample_file' => string '/s/o/software.jpg' (length=17)
          'sample_type' => string 'file' (length=4)
          'sort_order' => string '2' (length=1)
          'default_title' => string 'Sample 1' (length=8)
          'store_title' => string 'Sample 1' (length=8)
          'title' => string 'Sample 1' (length=8)