On Thursday February 2, 2017, version 1.2.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.2.19 release notes

This release has three minor bug fixes.

Library Thing weights

Category sets such as BISAC ('BI') or Consumer ('CN')  relate to ISBNs with an integer that indicates sequencing (as indicated by the seq element). Library Thing ('TA') categories also have an integer associated with the ISBN joins but rather than indicating sequencing, that value actually indicates weight. Previously this value had been passed along in the same seq element but it was pointed out that this behavior produced a problem when you tried to list all the Library Thing categories of a particular work. The query that is generated selects the smallest of all seq values among the ISBNs of that work with that category but with weights we would prefer to sum the possible values.

Therefore in this release, we've separated the Library Thing weights into a separate field and exposed sort=weight as a new sort option.

/domains/BOT/works/108336/categories?catSetId=TA&sort=weight&dir=desc

    "categories": [
      {
        "catId": 90000035069,
        "description": "fantasy",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 3259,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034177,
        "description": "epic",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 288,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000074123,
        "description": "a song of ice and fire",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 278,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034143,
        "description": "dragons",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 246,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034979,
        "description": "epic fantasy",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 230,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034340,
        "description": "war",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 152,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000035000,
        "description": "medieval",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 138,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000035097,
        "description": "politics",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 131,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034980,
        "description": "high fantasy",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 114,
        "_embeds": null,
        "_links": [
          
        ]
      },
      {
        "catId": 90000034076,
        "description": "adventure",
        "catUri": null,
        "menuText": null,
        "hasChildren": false,
        "seq": 0,
        "weight": 113,
        "_embeds": null,
        "_links": [
          
        ]
      }
    ],

The other two bug fixes are minor tweaks to parameter interpretations around a /works listing with rows=0 and a list of specific ISBNs and the other around the behavior of showBoxBundles=false.

Bug

• [RHAPI-635] - listWorkCategories sort by 'seq ' failing
• [RHAPI-638] - Investigate why showBoxBundles=false returns no records
• [RHAPI-640] - listWorks Sort by issues