• Register

Penguin Random House Developer Blog

Enhanced API v1.2.4 released

On Friday May 20, 2016, version 1.2.4 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.4 release notes

This fix was rushed into PRD to resolve an issue where works without covers were not being returned correctly by the product display view.

In addition some more new fields have been added to the product display output including canPrice and authorPhotoUrl. Two other code/description objects were added as well, grade and salesRestriction.

A new computed flag was added to the Title representation named 'MOVIE_TIE_IN' that is set whenever the TITLE.MTI field is 'Y' or TITLE.VERS is 'Movie Tie-In Edition'.

Two new filters were added, showMovieTieIn which restricts (or excludes) based on the that 'MOVIE_TIE_IN' flag and showExportOnly which does the same on the 'EXPORT' flag.

Finally, we worked with Mashery to better understand the configuration so that we could properly not cache certain requests. Any POST requests to the /titles or /works endpoint that needed to supply a large number of parameters are no longer cached. Also any request that includes "?sort=random" is not cached so that you can do this:

/domains/PRH.US/works?sort=random&rows=1

      "works":[
         {
            "workId":​302594,
            "title":"The Song of the Cid",
            "author":"Anonymous",
            "onsale":"2009-03-31",
            "language":"SP",

And then make the same request immediately and get a different result

      "works":[
         {
            "workId":​350665,
            "title":"Trading in the Zone",
            "author":"Mark Douglas",
            "onsale":"2001-01-01",
            "language":"E",

Bug

  • [RHAPI-222] - sort=random doesn't work with Mashery caching
  • [RHAPI-505] - Don't cache POST requests

New Feature

  • [RHAPI-508] - Create a filter on export editions

Task

  • [RHAPI-487] - Create a "Movie tie-in" flag
  • [RHAPI-492] - Add Canadian price to product-display
  • [RHAPI-494] - Add grade range description to product-display
  • [RHAPI-504] - Add author image link into product-display

Sub-task

  • [RHAPI-495] - Add salesRestriction (overhead field) to product-display