As a metadata user I want to filter API results for content with currently active licenses

As a metadata user I want to filter API results for content with currently active licenses

What

Member Rockefeller University Press as expressed that they'd like to be able to limit API results to just those with active licenses.

We can currently use has-license to limit results to just those with license metadata, and license.delay to limit results to those with a specific length of embargo. But because embargo lengths vary quite a bit, it would be complicated for a user to combine license.delay with from-pub-date or until-pub-date in such a way to ensure that all results have a currently active license.

This particular member didn't ask for this, but I can see the same utility in allowing a filter that checks for the presence or absence of the free_to_read tag and another that limits results to those where the free_to_read start date has already passed.

Why

It would enhance the utility of the REST API in general and the license metadata in particular.

How urgent

Definition of ready

  • Product owner: @ppolischuk1
  • Tech lead:
  • Service:: or C:: label applied
  • Definition of done updated
  • Acceptance testing plan:
  • Weight applied

Definition of done

  • Unit tests identified, implemented, and passing
  • SONAR on merge request branch checked by tech lead
  • SONAR on merge request branch checked by reviewer
  • Code reviewed
  • Available for acceptance testing via a staging URL, or otherwise
  • Consider any impacts to current or future architecture/infrastructure, and update specifications and documentation as needed
  • Knowledge base reviewed and updated
  • Public documentation reviewed and updated
  • Acceptance criteria met
    • AC 1
    • AC 2
  • Acceptance testing passed
  • Deployed to production

Prior to and during Backlog Refinement, consider the potential impacts this user story may have on the following areas:

  • Billing/costs
  • Internal documentation
  • External documentation
  • Schema
  • Outputs
  • Operations
  • Support & Membership experience
  • Outreach & Communications
  • Testing
  • Internationalization
  • Accessibility
  • Metrics, analytics, reporting

Additional details about the above items can be found here.

Notes

Edited by Sara Bowman