Penguin Random House Developer Blog

As of this morning, version 1.1.4 of the Enhanced PRH API has been released to production. The IO Docs have been updated to reflect the new parameters, some additional fields have been added to existing representations and one new endpoint has been added, /titles/{isbn}/characters. A detailed listing of changes follows.

If you encounter any problems with your applications as a result of these changes, please contact us at api@penguinrandomhouse.com.

Version 1.1.4 release notes

• RHAPI-268: added ignoreSeries parameter
• RHAPI-270: fixed a bug where sort=award was not working in v1.1.3
• RHAPI-271: add elements to the /series/{seriesCode}/views/series-display representation: seriesNumber, format and price
• RHAPI-273: fixed a bug where ignoreAuthor was not working when listing an author's titles in v1.1.3
• RHAPI-274: added subseries to the vanilla title representation
• RHAPI-276: added ignoreContribRole parameter
• RHAPI-277: fixed a bug where the view /works/{workId}/views/also-in/author was returning nested author objects of the main work, not of the returned works themselves
• RHAPI-279: optimized the SQL behind /works/views/list-display so that all the author data is fetched in a single query rather than separately for each
• RHAPI-281: add endpoint /titles/{isbn}/characters to expose the ISBNxCHARACTER table

Additional changes without JIRA tickets

• Added seq to the category representation when an ISBN or work ID has been specified
• Added workId to the title representation; the link with the work rel-type is still available and either fetching that resource or embedding it directly in the title call is the preferred method of accessing work-level data but there are cases wher the work ID itself was the data that was needed.
• Added frontlistiest to the /works/views/list-display representation to hold the ISBN related to the specified work in the specified domain with seq=1. The existing element isbn used to have this value but now it is allowed to vary with the query parameters. For example a request such as /domains/PRH.US/works/views/list-display?formatFamily=Ebook returns work ID 84 with the Trade Paperback in frontlistiest but with the lowest sequence value e-book in the isbn. In cases like this where you are returning a list of works but for a limited set of ISBNs, it gives you access to an ISBN that can be used to display a cover that is guaranteed to be in that limited set.

        "workId": 84,
        "title": "Catch Me If You Can",
        "onsale": "2000-08-01",
        "frontlistiest": 9780767905381,
        "isbn": 9780767915601,

• Added ignoreFormatCode parameter