<< Click to Display Table of Contents >> Navigation: DOI Identifier / Resolution Services > DOI Resolution Functions > Parameter Passing |
With the parameter passing feature, information about the context of the request (for example, the particular user making the request) can be included in the DOI resolution request sent to the DOI Proxy. Different context expressed in the request may result in different resolution results. Changes in context are predictable, and do not require the original creator of the hyperlink to handcraft different URLs for different contexts.
Two URLs are involved in the parameter passing feature:
•the referrer URL: URL sent by the requester (referrer) to the DOI Proxy and containing the DOI name to be resolved and the context information
•the referent URL: URL registered in the respective DOI record (by the referent) and which may also contain parameters
The DOI Proxy combines the referrer URL with the referent URL to create the out-bound link. It supports two different methods :
•urlappend: simple method (see below)
•OpenURL: deprecated method (see Appendix)
Parameter Passing with urlappend
With urlappend, key-value pairs can be passed to the out-bound link by placing them in the referrer URL as follows: https://doi.org/<doi-name>?urlappend=%3F<key1>=<value1>%26<key2>=<value2>... The question mark (%3F) or the ampersand (%26) must be used before each key-value pair. For example, If the referent URL already contains parameters then they may conflict with the urlappend values. In the above example, the urlappend should start with an ampersand character rather than a question mark character. |