On Friday May 13, 2016, version 1.2.3 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.2.3 release notes

This release fixes a bug where the Work representation's cover URL always used the frontlistiest ISBN but now choose the first  ISBN in frontlistiest order that has a cover.

The Sales platform web project requested several fields to be added to existing endpoints. The product-display view now includes both salesRestrictions and isbnHyphenated. The /title/{isbn}/content endpoint now contains two blurbs from the TI sheets, keynote and positioning. The author-display view includes the field consumerFormat.

The Title Narrative Tool project modified their ant views to include a list of divisions.

The Children's group requested the ability to restrict both search and restrictive search with the division facet. It was already available on /search for 'work' and 'isbn' documents but was not previously available to restrict 'author' and 'series' documents. It was also not previously available on the /search/predictive endpoint.

Finally, PRH.com requested a couple of new views that return data in the work's list-display representation. The views use the recently added CO_PURCHASE table to generate a list of works that are related to the specified item based on the entries in this table. The view can be accessed three different ways: as /authors/{authorId}/views/also-purchased, /titles/{isbn}/views/also-purchased or /works/{workId}/views/also-purchased. There is also a new view that uses entries in the CATEGORY table in the 'LT' category set (Library Thing) to come up with a list of related works. This can be specified as /titles/{isbn}/views/matches-on-tag.

You can now also specify 'price' as a valid sort option. If you do, you must also specify either 'USD' or 'CAD' for the new parameter sortPriceTypeCode.

Bug

• [RHAPI-475] - Work cover image link may be to a non-existant cover

New Feature

• [RHAPI-444] - Add sales restrictions full rights to API
• [RHAPI-461] - Filter predictive search by Division
• [RHAPI-471] - Search for author and series documents with division facet
• [RHAPI-479] - Implement a sort parameter by price
• [RHAPI-484] - Create "also-purchased" works list view
• [RHAPI-485] - Create "matches-on-tag" works list view
• [RHAPI-486] - Add "subSeries" filter parameter

Task

• [RHAPI-473] - Add to the API the positioning statement and the short description from the TI sheet
• [RHAPI-483] - Add "divisions" to ant views
• [RHAPI-488] - Add title consumerFormat to author-display
• [RHAPI-491] - Add isbnHyphenated to product-display