On Thursday April 14, 2016, version 1.1.19 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.19 release notes

This version saw several additions to the output and one new parameter added to the author display view. In addition one bug was fixed where under certain circumstances, work listings could display duplicate records.

The Title representation received two new fields, salesRestriction and isbnBlok,  values for which come straight from our internal systems. In addition we added a new derived flag in the flags element called "EXPORT" which is set whenever isbnBlok='EXPT' and is used to indicate an export-only edition.

/domains/SALESINTERNATIONAL/titles/9781601429278

            "flags":[
               "EXPORT"
            ],
            ...
            "titleBlock":"EXPT",

The Event representation had a new field added to the output.

/domains/PRH.US/events/1705290

            "referenceUrl":"www.bn.com",

The author display view was modified to include several new fields in the output.

/domains/SALESINTERNATIONAL/authors/29660/views/author-display

            "formatCode":"HC",
            ...
            "canPrice":null,
            ...
            "ageRange":null,
            "salesRestriction":null,
            "salesRestrictionCode":"07",
            ...
            "flags":[
               "INSIGHT"
            ],

In addition, a new parameter was added to the author display view, "preferExport". This parameter allows the international sales sites to display the correct cover without having to modify the existing frontlistiest logic. This boolean parameter can be set to true to control which ISBN is chosen for each of the works listed in the works array.

For example, let's look at work #252887 in the "SALESINTERNATIONAL" domain. It has two titles, one with the "EXPORT" flag and one without. The export edition has a frontlistiest sequence of 2 and so would normally not be selected as the ISBN for the author display works array.

/domains/SALESINTERNATIONAL/works/252887/titles?sort=frontlistiest

      "titles":[
         {
            "isbn":​9781601428165,
            "isbnHyphenated":"978-1-60142-816-5",
            "title":"Be Light",
            ...
            "flags":[
               "INSIGHT"
            ],
            "workId":​252887,
            "frontlistiestSeq":​1,
            ...
         },
         {
            "isbn":​9781601429278,
            "isbnHyphenated":"978-1-60142-927-8",
            "title":"Be Light",
            ...
            "flags":[
               "EXPORT"
            ],
            "workId":​252887,
            "frontlistiestSeq":​2,

Without preferExport set, the author display view selects the frontlistiest ISBN for each work returned.

/domains/SALESINTERNATIONAL/authors/244262/views/author-display

      "works":[
         {
            "id":​252887,
            "name":"Be Light",
            "isbn":​9781601428165,

However if preferExport is set to 'true', then ISBNs with the "EXPORT" flag will be preferred. Notice how the request below returns the ISBN ending in 9278 which had a frontlistiest sequence of 2.

/domains/SALESINTERNATIONAL/authors/244262/views/author-display?preferExport=true

      "works":[
         {
            "id":​252887,
            "name":"Be Light",
            "isbn":​9781601429278,

Bug

• [RHAPI-450] - work listing not returning distinct records

New Feature

• [RHAPI-431] - Add ISBN_BLOK to API

Task

• [RHAPI-434] - Add Sales Restriction field to API
• [RHAPI-435] - Add title block field to API title representation
• [RHAPI-437] - Add parameter to author display view to make works listing prefer export only edition
• [RHAPI-439] - Add REFERENCE_URL column to AUTHOREVENTS
• [RHAPI-445] - Add additional fields into views/author-display