Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The “Retrieve Issues of a Journal” endpoint allows a client to retrieve the metadata for issues published for a given journal in the Third Iron metadata database. Optionally, the endpoint can fetch issues that contain new content over a specific date range.

Note

Contact

BrowZine

Third Iron Support to Request your API Key

Email us at support@thirdiron.com to request your API Key.  The BrowZine Data Service API can only be used by institutions subscribing to the BrowZine Third Iron Data Service.

Submit a GET request against this endpoint, filling in the appropriate path segments with the id number of your library and with the id number of the journal whose issues you are trying to retrieve, and your application will get a response representing that journal's issues. Responses contain:

...

Supported Methods

GET

Endpoint Location

/public/v1/libraries/:library_id/journals/:journal_id/issues

Endpoint Parameters

:library_id

Required. Replace the :library_id portion of the endpoint path with the id # of your library

:journal_id

Required. Replace the journal_id portion of the path with the id number for the journal whose issues you wish to retrieve


new_content_start_date

Optional query string parameter. If present, new_content_end_date must also be present.

Format this value as YYYY-MM-DD.

When present, this will cause the endpoint to only include issues that have new content between new_content_start_date and new_content_end_date , inclusive of those two dates. The date range must be within the last 6 months. Karl Becker Just confirming this is correct - I thought this was less like 30 days…?

This value must be earlier or equal to new_content_end_date

new_content_end_date

Optional query string parameter. If present, new_content_start_date must also be present.

Format this value as YYYY-MM-DD.

When present, this will cause the endpoint to only include issues that have new content between  new_content_start_date and new_content_end_date , inclusive of those two dates. The date range must be within the last 6 months.

This value must be later or equal to new_content_start_date

...