On Wednesday December 20, 2017, version 1.3.9 of the Enhanced PRH API was released to production. If you encounter any problems with your applications as a result of these changes, please contact us at api@penguinrandomhouse.com.

Version 1.3.9 release notes

This release includes some bug fixes and new features to support the Sales websites and PRH United app. Among the new features are a couple of new parameters.

Zoom categories

One of these new parameters is zoomCatSetId which RHAPI-829 shows is necessary whenever the zoom parameter identifies that we want to include categories. If we need to limit the category set from which the categories are drawn and yet we don't want that category set to be a limit on the titles that are being returned from the primary listing, then the zoomCatSetId should be specified and the category listing will be filtered but the listing will not be.

Award filtering

We've always supported the showAwards parameter which will restrict results to just titles that have won an award. However you may now specify one or more awardLevel and awardDesc parameters to filter any listing based on specific entries in the ISBNxAWARD table. Here is a sample request:

/domains/PRH.US/works?awardLevel=WINNER&awardDesc=Man%20Booker%20Prize

This will allow for a more customized and granular approach to finding a specific award winner or for finding a list of titles or works that have one of several prizes in common. If you need more information on awards or the possible values for these parameters, please contact us at api@penguinrandomhouse.com.

Bug

• [RHAPI-829] - /title end point with categories zoom returns an error when the title has no categories
• [RHAPI-841] - The frontlistiest ISBN returned in sales-dispay is not correct when applying sort=frontlistiest_onsale
• [RHAPI-842] - [UK] ISTCA search view not testing correct contrib role code for UK authors

New Feature

• [RHAPI-839] - Add awardDesc and awardLevel filter parameters

Task

• [RHAPI-821] - Update ignoreDivisionCode clause in siteFilter=CommonReads
• [RHAPI-822] - Remove ignoreDivisionCode clause from siteFilter=Retail
• [RHAPI-823] - Add acmartflap (AcMart book copy) to /views/product-display
• [RHAPI-824] - Add acmartflap (AcMart book copy) to /search/views/search-display
• [RHAPI-828] - Add categories zoom to /works/views/sales-display
• [RHAPI-831] - Expose Australia data via API
• [RHAPI-835] - Change recommend-from-simile to be able to use 3 dimensions