On Thursday February 18, 2016, version 1.1.17 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.1.17 release notes

New fields

The work product display got two new elements added  to its representation: the "copyright" field that relates to the text excerpt and the "hasAuthorPhoto" field that (as you might guess) tells you whether an author photo exists.

New parameters

List endpoints can now take three new parameters related to age ranges: "ageRange", "ageRangeMin", "ageRangeMax". The "ageRange" field takes a list of values and expects strings like those that are found in SAP which are 4 characters long and are a concatenation of a two digit lower bound and two digit upper bound such as '0005' or '0408'. This parameter can be used to test for specific age range values such as books tagged as appropriate for ages 4 to 8 ('0408') but not any others. The "ageRangeMin" and "ageRangeMax" take single integer values and can be used to do a mathematical comparison without enumerating all the different age range pairs. For example if you set "ageRangeMin" to '4', then you would get back titles tagged with the '0408' age range and also the '0005' age range as well as any others where the max of the range indicated is greater than or equal to 4.

Predictive search changes

We have done some work behind the scenes to improve the quality of the predictive search results. The biggest improvement is around searching when the entry is a complete token (e.g. 'Janet') instead of just a partial (e.g. 'Ja'). In general, these results should now be much closer to the results you would get when you do a "regular" search.

Bug

• [RHAPI-326] - Predictive search returning different score for 'janet'
• [RHAPI-405] - listEvents bad SQL error
• [RHAPI-407] - /divisions returns duplicates
• [RHAPI-411] - eBooksOriginal + series.minPrintScore = 0 problem?

New Feature

• [RHAPI-408] - Add ISBNxMAIN.COPYRIGHT field to product display view
• [RHAPI-409] - Adding hasAuthorPhoto to /works/ID/views/product-display
• [RHAPI-413] - Add "ageRange", "ageRangeMin" and "ageRangeMax" parameters
• [RHAPI-422] - Add catUri and divisionCode parameters to getWorkViewAlsoInSeries