BrowZine offers a number of durable linking options which allows for easy creation of durable links into the BrowZine Web interface.  These links are easy to generate - simply navigate to a spot within BrowZine and copy the URL from the bar.  This is then a durable URL that can be sent to anyone else to be linked to that location in BrowZine.  However, there are also a number of other perhaps more "hidden" features involved in linking which this guide will detail to present as many options as possible to utilize BrowZine within your website or application.

Library-Specific Basic Linking Syntax

These types of links are known as "Library-Specific" since the URL contains the Library ID.  This forces the user, even if they have an active token associating them with ANOTHER library, to view the link with the library ID specified in the URL.  This makes this a great choice for a library to use these types of links on their own site to ensure that the user has a consistent experience when linking to BrowZine as what the library would see when the link was created.

Name of FunctionLink Syntax
Link to the BrowZine Home Page for a specific Library

https://browzine.com/libraries/:library_id

Example: https://browzine.com/libraries/73

Link to the BrowZine Home Page with a query pre-populated

https://browzine.com/libraries/:library_id/subjects?query=surgery

Example: https://browzine.com/libraries/73/subjects?query=surgery

Example (ISSN): https://browzine.com/libraries/73/subjects?query=2044-7248

Example (ISSN, no dash): https://browzine.com/libraries/73/subjects?query=20447248

Link to the BrowZine Home Page with a query pre-populated, filtering to show journals only

https://browzine.com/libraries/:library_id/subjects?filter=journals&query=surgery

Example: http://browzine.com/libraries/73/subjects?filter=journals&query=surgery

Link to the BrowZine Home Page with a query pre-populated, filtering to show subjects only

http://browzine.com/libraries/:library_id/subjects?filter=bookshelves&query=surgery

Example: http://browzine.com/libraries/73/subjects?filter=bookshelves&query=surgery

Link to a Taxonomy Category for a specific Library

https://browzine.com/libraries/:library_id/subjects/:subject_id/bookcases/:bookcases_id/bookshelves/:bookshelves_id

Example: https://browzine.com/libraries/73/subjects/60/bookcases/94/bookshelves/319

Link to a Taxonomy Category for a specific Library sorted by SJR Value

https://browzine.com/libraries/:library_id/subjects/:subject_id/bookcases/:bookcases_id/bookshelves/:bookshelves_id?sort=rank

Example: http://browzine.com/libraries/73/subjects/60/bookcases/94/bookshelves/319?sort=rank

**Note. Without this qualifier the sort is by title. You can force this as well by using ?sort=title

Link to the current issue of a Journal for a specific Library by journal ID

https://browzine.com/libraries/:library_id/journals/:journal_id/issues/current

Example: http://browzine.com/libraries/73/journals/37259/issues/current

Link to the current issue of a Journal for a specific Library by ISSN

https://api.thirdiron.com/v2/libraries/:library_id/external-search?query=:journal_issn 

Example: https://api.thirdiron.com/v2/libraries/73/external-search?query=2044-7248

**Note - the above will automatically forward to the /current link shown above if the ISSN matches a journal in BrowZine. If it does not, it will attempt to execute the ISSN search into the library's A-Z system automatically.


Library-Independent Linking Syntax using BrowZine Link™

These links within BrowZine are designed to NOT have a library ID specified to them.  These types of links are useful for users to share with other users, for publishers to use and other third parties where the user of the link is not known and thus could affiliated with any BrowZine library.  These links will partake in the process of token assignment which BrowZine uses to store knowledge of the user's library affiliation in the local storage area of their web browser.  If the user does NOT have a token active and one of these links is used and BrowZine is not able to match up the user to a library based on their IP address, a WAYF (Where Are You From) screen will be presented where the user can select their correct institution.  This then allows the user to resolve the link using their local holdings data.

These two linking structures then afford a great deal of power for scholarly article sharing by producing a consistent syntax which has knowledge of authentication and entitlements for each individual library!

Name of FunctionLink SyntaxExample Link
Link to an article within the context of its originating issue by DOIhttps://browzine.com/articles/doi/:article_doihttps://browzine.com/articles/doi/10.1056/NEJMe1702728
Link to an article (fully resolved at the publisher/platform) by BrowZine Article IDhttp://browzine.com/articles/:article_idhttps://browzine.com/articles/75293908