GetProducts

This function returns detailed information for single products. It requires a list of specified product IDs as input. The presentation type can be set: if ‘detailed presentation’ (parameter ‘Details’) is set to ‘false’, this considerably reduces the quantity of data transferred and therefore speeds up the search. The returned data includes the fields "Price" and "DisplayPrice". To display the price on the screen, use only the "DisplayPrice" field because this is the type of display requested by the program operator for his product(s). The partner is solely liable for correctly displaying the price(s) on his website. The same applies to the ShippingPrice.

To access live data, please use this WSDL file:
https://api.affili.net/V2.0/ProductServices.svc?wsdl
To access demo data, please use this WSDL file:
https://developer-api.affili.net/V2.0/ProductServices.svc?wsdl

Web service description

Test data document

Operation test

With this form, you can try out this web service. We already filled it out with a sample request which will return data. Feel free to fill in different parameter values - our test data reference gives you an overview of our sample data.

Field	Type	Values
PublisherId *	int
ProductIds *	int array
Details *	bool
ImageSize *	enum
CurrentPage *	int
PageSize *	int
SortBy	enum
SortOrder *	int

XML response

Short paramter definitions

PublisherId (int):: Id of the publisher whose account is being used.
ProductIds (array of int):: Array of product Ids.
Details (bool):: States whether the detailed view of product results is required.
ImageSize (enum):: The 'ImageSize' parameter can be used to select which images (product image and shop logo) should be included in the results. The number behind “Image” resp. “Logo” represents the width in pixels. Possible values are:no image, Product image: Image30 & Logo: Logo50, Product image: Image60 & Logo: Logo90, Product image: Image90 & Logo: Logo120, Product image: Image120 & Logo: Logo150, Product image: Image180 & Logo: Logo468, All images
CurrentPage (int):: States which page should be displayed.
PageSize (int):: States the size of a result page.
SortBy (enum):: States by which field the results should be ordered. If omitted, results are sorted by rank. Possible values are: Price, Title, Rank
SortOrder (enum):: States the required order direction of the results. Possible values are: unsorted, ascending, descending, random

Complete code examples

<?php

/* <LIVE DATA>
define ("WSDL_LOGON", "https://api.affili.net/V2.0/Logon.svc?wsdl");
define ("WSDL_PROD",  "https://api.affili.net/V2.0/ProductServices.svc?wsdl");

$Username   = ""; // the publisher ID
$Password   = ""; // the product data web services password

$SOAP_LOGON = new SoapClient(WSDL_LOGON);
$Token      = $SOAP_LOGON->Logon(array(
             'Username'  => $Username,
             'Password'  => $Password,
             'WebServiceType' => 'Product'
             ));
$params = array(
          'ProductIds' => array('23275425','18732502'),
          'Details' => true,
          'ImageSize' => 'AllImages',
          'CurrentPage' => '1',
          'PageSize' => '10',
          'SortBy' => 'Rank',
          'SortOrder' => 'Descending'
          );
</LIVE DATA> */

/* <DEMO DATA> */
define ("WSDL_LOGON", "https://developer-api.affili.net/V2.0/Logon.svc?wsdl");
define ("WSDL_PROD",  "https://developer-api.affili.net/V2.0/ProductServices.svc?wsdl");

$Username   = '';     // your developer ID
$Password   = '';     // your developer portal password
$DemoPublisherId   = 403233;  // one of the publisher IDs of our demo database
$DeveloperSettings = array('SandboxPublisherID' => $DemoPublisherId);

$SOAP_LOGON = new SoapClient(WSDL_LOGON);
$Token      = $SOAP_LOGON->Logon(array(
                     'Username'  => $Username,
                     'Password'  => $Password,
                     'WebServiceType' => 'Product',
                     'DeveloperSettings' => $DeveloperSettings
                     ));
$params = array(
          'ProductIds' => array('106020024','113302893'),
          'Details' => true,
          'ImageSize' => 'AllImages',
          'CurrentPage' => '1',
          'PageSize' => '10',
          'SortBy' => 'Rank',
          'SortOrder' => 'Descending'
          );
/*</DEMO DATA> */

$SOAP_REQUEST = new SoapClient(WSDL_PROD);
$req = $SOAP_REQUEST->GetProducts(array(
            'CredentialToken' => $Token,
            'GetProductsRequestMessage' => $params
            ));

print_r($req);

?>

protected void LoadWebService()
{            
    // first create the Web References
    // LIVE DATA
    // using Affilinet.LogonWebservice; ("https://api.affili.net/V2.0/Logon.svc?wsdl")
    // using Affilinet.ProductWebservice; ("https://api.affili.net/V2.0/ProductServices.svc?wsdl")    

    // or DEMO DATA
    // using Affilinet.LogonWebservice; ("https://developer-api.affili.net/V2.0/Logon.svc?wsdl")
    // using Affilinet.PublisherProgramWebservice; ("https://developer-api.affili.net/V2.0/ProductServices.svc?wsdl")    

    #region Parameters for the authentification token
    // Insert the publisher ID for access the live data or insert your DeveloperId for access the demo data 
    string Username   = "";
    // Insert the publisher web services password for access the live data or insert your developer portal password for access the demo data 
    string Password   = "";
    // only required for access the demo data. Insert one of the publisher IDs of our demo database. e.g.: 403233
    int SandboxPublisherID = 0;
    #endregion

    string myToken = GetAuthentificationToken(Username, Password, SandboxPublisherID, WebServiceTypes.Product);
    
    // insert the product Ids to get the products
    int[] productIds = { 106020024 };
    ProductSearchResult myResult = GetProducts(myToken, productIds, true, ImageSize.AllImages, 1, 10, SortBy.Rank, SortOrder.Descending);
}

public static string GetAuthentificationToken(string username, string password, int sandboxPublisherID, WebServiceTypes WSType)
{
    Logon logonRequest = new Logon();
    logonRequest.Username = username;
    logonRequest.Password = password;
    logonRequest.WebServiceType = WSType;
    
    // *** only required for sandbox requests *** 
    // logonRequest.DeveloperSettings = new TokenDeveloperDetails();
    // logonRequest.DeveloperSettings.SandboxPublisherID = sandboxPublisherID;
    // logonRequest.DeveloperSettings.SandboxPublisherIDSpecified = true;             

    Authentication logonService = new Authentication();
    return logonService.Logon(logonRequest);
}

public static ProductSearchResult GetProducts(string token, int[] productIDs, bool details, ImageSize imageSize, int currentPage, int pageSize, SortBy sortBy, SortOrder sortOrder)
        {
            ProductServices prodService = new ProductServices();        
            GetProductsRequest gprq = new GetProductsRequest();
            gprq.GetProductsRequestMessage = new GetProductsRequestMessage();
            gprq.CredentialToken = token;
            gprq.GetProductsRequestMessage.ProductIds = productIDs;
            gprq.GetProductsRequestMessage.Details = details;
            gprq.GetProductsRequestMessage.ImageSize = imageSize;
            gprq.GetProductsRequestMessage.CurrentPage = currentPage;
            gprq.GetProductsRequestMessage.PageSize = pageSize;
            gprq.GetProductsRequestMessage.SortBy = sortBy;
            gprq.GetProductsRequestMessage.SortOrder = sortOrder;
            return prodService.GetProducts(gprq);
        }

GetProducts

GetProducts

Web service description

Test data document

More questions?

Operation test

XML response

Complete code examples

PHP

.NET