• Register

Penguin Random House Developer Blog

Enhanced API v1.2.2 released

On Tuesday May 3, 2016, version 1.2.2 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.2 release notes

A bug fix for PRH.com was made regarding the series count on the author display view and some new features were added for the Author Alerts e-mail program.

The Work list display view got two new fields added to the representation, hasExcerpt and subtitle.

Several filter parameters were added: salesRestriction, saleStatus, subFormat, ignoreSubFormat, ignoreProductLine, ignoreProductType, showNoTitleBlock, workOnSaleFrom and workOnSaleTo. All of these parameters can be supplied for any list request (e.g. /works, /authors, /events). All but the last two are simply filters on columns of the TITLE table though the boolean test "showNoTitleBlock" is actually a test for a not null condition on the element returned as "titleBlock". The two date range parameters workOnSaleFrom and workOnSaleTo were added to allow requests to distinguish between filtering on the TITLE.ONSALEDATE (which is what the current onSaleFrom and onSaleTo do) to requests that would prefer to test WORK.ONSALEDATE.

In addition the awkwardly (and inconsistently) named parameter "hideBooksWithNoCover" has been deprecated and replaced with the better "showCovers". The old parameter has not been removed and will continue to work but going forward the IO Docs will show the better parameter name to encourage its use.

Bug

  • [RHAPI-464] - Inconsistent series counts between author and series views?

New Feature

  • [RHAPI-466] - Add filter parameters to support Author Alerts program
  • [RHAPI-467] - Add fields to work list display to support Author Alerts program

Version 1.2.1 release notes

Previously version 1.2.1 was released as a hot fix. Since no announcement was made of that fix, I'll include the JIRA tickets for reference here.

Bug

  • [RHAPI-462] - listTitles with ISBNs supplied does not correctly order results when rows=0
  • [RHAPI-465] - listTitles with ISBNs supplied does not honor a sort specification