VNP Output Webservices - Products info
"getProductInfo.jsp" is an output VirtualNewspaper webservice that can be used to get all the details about any existing product or subscription. Every request will provide a JSON reply.
This webservice can be invoked providing both GET or POST parameters.
Warning:
All of the below described POST calls, need to be url encoded
Webservice usage examplehttp://DOMAIN/VNP/webservice/getProductInfo.jsp?timestamp=TIMESTAMP&authCode=md5(TIMESTAMP+PRIVATEKEYWS)
e.g.
domain: newsstand.mydomain.com
vnp: myvnp
timestamp: 1728466997
privatekeyws: abc123
authCode: md5(timestamp+privatekeyws) = md5(1728466997abc123) = a2318bc372a3da18cbb2386a8dcaff80
resulting URL: https://newsstand.mydomain.com/myvnp/getProductInfo.jsp?timestamp=1728466997&authCode=a2318bc372a3da18cbb2386a8dcaff80
optional parameters:
productId
used to retreive details about a specific product.
If no product_id is provided, the page returns all the products or those filtered by the following params.
title
filter the products belonging to the specific publication name (as written in the field "directory" of the title definition)
externalCode
returns products marked with the specific "product code" (Shops & Payments sectionof the product page)
shop
1 = web, 2 = itunes, 3 = all
This webservice will reply as follow :
[
{
fullprice: "150.00", // The slashed price
shop: "1", // Sellable in market => 1: only web and android, 2: only iTunes, 3: both
weight: "0.000", // Weight of the paper
productDescription: "test", // Textual description of the product
pdf: "pdf", // Can download the pdf => "pdf": can download, "" can't download
userTarget: "privato", // Private or business kind of product
credits: "1", // In case of productType(parameter bottom) => "online-scalare" is the number of credits can be used purchasing this product
billable: "1", // The order may be billed
productType: "online-temporale", // Possible values => "online-temporale": subscription, "online-scalare": credits product (or single copy), "cartaceo" => only paper
currency: "EUR", // The currency this product can be sold
workstations: "1", // Deprecated
archiveMonths: "0", // Months of archive activated with this product
availability: 21, // Quantity of paper copies available in the store
productCode: "", // External code product
label: "test", // A bunch of words which describe a product
apple_product_id: "0", // The Apple id for this product
productId: "1979", // Internal Id of this product
shopURL: "http://[wwx].virtualnewspaper.it/editorName/includes/shop/list_products.jsp?idProdotto=1979", // the link to the internal shop to purchase this product
price: "100.00", // The price configured to the product during the creation
currencySymbol: "€", // Deprecated
issues: "", // Issues associated to this product
periodType: "month", // possible values: "Day", "Week", "Month" Time period
titles: "[title1,title2]", // Titles associated to this product
productName: "test - Web/Android", // Name of the product
period_qty: "12" // Quantity of time periods
}
]