adsabs/resolver_gateway repository overview

⁠ADS Resolver Gateway

⁠Short Summary

This microservice captures and logs information such as search, abstract view etc.

⁠Setup (recommended)

$ virtualenv python
$ source python/bin/activate
$ pip install -r requirements.txt
$ pip install -r dev-requirements.txt
$ vim local_config.py # edit, edit

⁠Testing

On your desktop run:

$ py.test

⁠API

⁠Make a GET request with a bibcode to return all links associated with that bibcode:

curl -X GET https://ui.adsabs.harvard.edu/link_gateway/<bibcode>

For example to return all links associated with 2017arXiv170909566R, you would do

curl -X GET https://ui.adsabs.harvard.edu/link_gateway/2017arXiv170909566R

⁠Make a GET request with a bibcode and link type to return all links of the type specified associated for that bibcode:

curl -X GET https://ui.adsabs.harvard.edu/link_gateway/<bibcode>/<link_type>

For example to return links for all full text sources, you would do

curl -X GET https://ui.adsabs.harvard.edu/link_gateway/2013MNRAS.435.1904M/esource

⁠Available Link Types:

<link_type> is one of the following (case-insensitive):

• abstract Abstract
• citations Citations to the Article
• references References in the Article
• coreads Also-Read Articles
• toc Table of Contents
• openurl
• metrics
• graphics
• esource Full text sources
  • pub_pdf Publisher PDF
  • eprint_pdf Arxiv eprint
  • author_pdf Link to PDF page provided by author
  • ads_pdf ADS PDF
  • pub_html Electronic on-line publisher article (HTML)
  • eprint_html Arxiv article
  • author_html Link to HTML page provided by author
  • ads_scan ADS scanned article
  • gif backward compatibility similar to /ads_scan
  • preprint backward compatibility similar to /eprint_html
  • ejournal backward compatibility similar to /pub_html
• data On-line data
  • aca Acta Astronomica Data Files
  • alma Atacama Large Millimeter/submillimeter Array
  • ari Astronomisches Rechen-Institut
  • astroverse CfA Dataverse
  • atnf Australia Telescope Online Archive
  • author Author Hosted Dataset
  • bicep2 BICEP/Keck Data
  • cadc Canadian Astronomy Data Center
  • cds Strasbourg Astronomical Data Center
  • cxo Chandra X-Ray Observatory
  • esa ESAC Science Data Center
  • eso European Southern Observatory
  • gcpd The General Catalogue of Photometric Data
  • gtc Gran Telescopio CANARIAS Public Archive
  • heasarc NASA's High Energy Astrophysics Science Archive Research Center
  • herschel Herschel Science Center
  • ibvs Information Bulletin on Variable Stars
  • ines IUE Newly Extracted Spectra
  • irsa NASA/IPAC Infrared Science Archive
  • iso Infrared Space Observatory
  • koa Keck Observatory Archive
  • mast Mikulski Archive for Space Telescopes
  • ned NASA/IPAC Extragalactic Database
  • nexsci NASA Exoplanet Archive
  • noao National Optical Astronomy Observatory
  • pasa Publication of the Astronomical Society of Australia Datasets
  • pdg Particle Data Group
  • pds The NASA Planetary Data System
  • simbad SIMBAD Database at the CDS
  • spitzer Spitzer Space Telescope
  • tns Transient Name Server
  • vizier VizieR Catalog Service
  • xmm XMM Newton Science Archive
  • zenodo Zenodo Archive
• inspire HEP/Spires Information
• librarycatalog
• presentation Multimedia Presentation
• associated Associated Articles

⁠Identification Link Types:

Please note that these links types' endpoints differ slightly from the rest of link types:

curl -X GET https://api.adsabs.harvard.edu/link_gateway/<bibcode>/<Identification Link Type>:<id>

where Identification Link Types are: doi or arXiv and id is their respective identification. For example

curl -X GET https://dev.adsabs.harvard.edu/link_gateway/2010ApJ...713L.103B/doi:10.1088/2041-8205/713/2/L103
curl -X GET https://dev.adsabs.harvard.edu/link_gateway/2018arXiv180303598K/arXiv:1803.03598

⁠Maintainer(s)

Golnaz