SHERPA/JULIET Logo   . . . opening access to research  
Inicio  •  Buscar •  Funders •  Key to symbols •  Notify a policy •  Sobre  

Application Programmers' Interface

English | Español  

Current Prototype

This is a prototype API, and should not be used for business-critical applications.

The JULIET API works in a similar manner to the SHERPA/RoMEO API, where queries and output options are specified by adding parameters to a base URL. These are listed and described below.

The base URL is:

http://www.sherpa.ac.uk/juliet/api-epsilon.php

We would very much appreciate feedback on any aspect fo this prototype, for instance; how far it goes towards meeting your requirements, the suitability of the output, etc.

Parameters

Parameter values are case insensitive. Where they contain spaces or other special characters, they should be URL-encoded.

Parameters may be used in combination, although logically incompatible combinations may yield zero results.

Query Parameters

• &juliet_id= Funder's JULIET persistent identifier - comma separated list of numbers.
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=12
• &name= Name string. Literal string or substring only in the current prototype. N.b. There is no parsing of keywords or handling of quoted strings.
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?name=howard%20hughes
• &nametype= Name field to be queried - one of name, acronym, or either [default]. Must be used with the &name= parameter.
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?name=EPSRC&nametype=acronym
• &country= 2-letter ISO Country code - e.g. ca
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?country=ca
• &all= Find all funders = yes or any non-null value
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?all=yes

Output Parameters

• &policytype= Amount of policy information to be returned. One of:
  • all All policy data [default]
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=5&policytype=all
  • pubs Publication policies only
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?country=us&policytype=pubs
  • data Data policies only
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?country=ca&policytype=data
  • summary One line summaries for both policies
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?country=se&policytype=summary
  • none None - i.e. funders' names and countries only
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?all=yes&policytype=none
• &sortby= Sorting option. One of:
  • name Funders' names [default]
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?country=gb&sortby=name
  • country Country name
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?all=yes&sortby=country
• &markup= Markup format for output. One of:
  • xml XML [default]
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=29&markup=xml
  • json JSON
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=293&markup=json
  • php PHP array definition code for use in eval() commands.
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=302&markup=php
  Future additional alternative mark-up formats will be considered
• &lang= 2-letter ISO Language code for output - default en = English. Currently only English is supported.
e.g. http://www.sherpa.ac.uk/juliet/api-epsilon.php?juliet_id=9&lang=en

 

JULIET information is accurate to the best of our knowledge, but should not be relied upon for legal advice

© 2006-2017, University of Nottingham Contáctenos