Request Query

Request Query service URL for multiple requests

http://HOSTNAME/portal-service/request/query/my?aid=${aid}&type=${query_type} [&xdays=${xdays}][&fullRecord=0/1]

${aid} is the authorization id for the user logged in. The {aid} is provided by the Authentication service.

${query_type} the following values may be substituted:

xdays
all
open
allposttoweb
unopenedposttoweb
onloan

${xdays} can be any positive number. It is a conditional parameter and required only when query_type is xdays.

${fullRecord} can be either 0 or 1. It is an optional parameter and by default is considered 0 if not included

HTTP Method: GET
HTTP Header User-Agent: ${user-agent}

Standard http clients (browser, http client libraries etc.) automatically include it's User-Agent value.

Esempi

1. To retrieve all requests submitted in the last 7 days. Return full details for the requests.

http://HOSTNAME/portal-service/request/query/my?aid=12knsfd987234ldfd2&type=xdays&xdays=7&fullRecord=1

2. To retrieve all requests. Return the brief version of the request details.

http://HOSTNAME/portal-service/request/query/my?aid=12knsfd987234ldfd2&type=all&fullRecord=0

3. To retrieve all open requests. Return the brief version of the request details.

http://HOSTNAME/portal-service/request/query/my?aid=12knsfd987234ldfd2&type=open

4. To retrieve all requests for which documents were sent via post to web. Return the brief version of the request details.

http://HOSTNAME/portal-service/request/query/my?aid=12knsfd987234ldfd2&type=allposttoweb

5. To retrieve all requests for which documents were sent via post to web but have not been opened yet. Return the brief version of the request details.

http://HOSTNAME/portal-service/request/query/my?aid=12knsfd987234ldfd2&type=unopenedposttoweb

6. To retrieve all requests for which items are on loan. Return the brief version of the request details.

Request Query service URL for a single request

http://HOSTNAME/portal-service/request/query/my/${REQUEST_NUMBER}?aid=${aid}

${REQUEST_NUMBER} is any valid Relais request number.

${aid} is the be the authorization id for the logged in user.

${fullRecord}can be either 0 or 1. It is an optional parameter and by default is considered 0 if not included

HTTP Method: GET
HTTP Header User-Agent: ${user-agent}

Standard http clients (browser, http client libraries etc.) automatically include it's User-Agent value.

Esempio

1. To retrieve request number PAT-10000001. Return the brief version of the request details.

http://HOSTNAME/portal-service/request/query/my/PAT-10000001?aid=12knsfd987234ldfd2

Response

The response from this service is a JSON string. The following is a sample response for a successful query.

{
"MyRequestRecordOverflow":true,
"MyRequestRecords":[
{
"RequestNumber":"PAT-10012688",
"Title":"THE CANADIAN JOURNAL OF NEUROLOGICAL SCIENCES / LE JOURNAL CANADIEN DES SCIENCES NEUROLOGIQUES",
"ArticleTitle":"A CANADIAN PARADOX: TOMMY DOUGLAS AND EUGENICS.",
"ArticleAuthor":"SHEVELL, MICHAEL",
"DateSubmitted":"2015-11-07 22:36:34.000",
"Volume":"Vol:39", *
"PublicationDate":"2010", *
"Issue":"NO:1", *
"Issn":"0317-1671", *
"PagesRequested":"35-", *
"DeliveryDate":"2015-11-23 12:31:24.000", *
"RequestStatus":"UNFILLED"
"RequestStatusDate":"2015-11-23 12:31:24.000",
"ExceptionCodeDesc":"NOL"
},
{
"RequestNumber":"PAT-10012688",
"Title":"A NEW GREEN HISTORY OF THE WORLD : THE ENVIRONMENT AND THE COLLAPSE",
"Author":"Ponting, Clive",
"DateSubmitted":"2015-11-10 16:41:39.000",
"DueDate":"2015-12-24 11:59:59.000",
"PublicationType":"B", *
"PublicationDate":"2007", *
"PublicationPlace":"New York", *
"Edition":"Rev. ed.", *
"Isbn":"9780143038986", *
"DeliveryDate":"2015-11-17 16:41:39.000", *
"RequestStatus":"ON_LOAN"
"RequestStatusDate":"2015-11-17 16:41:39.000",
"ExceptionCodeDesc":"LON"
},
]

}

The following values may be returned in the response:

Campo	Nota
RequestNumber
Titolo
SubTitle
Autore
ArticleTitle
ArticleAuthor
SeriesTitle
DateSubmitted
ISO8601DateSubmitted	format = yyyyMMddhhmmss
NeedByDate
ISO8601NeedByDate	format = yyyyMMddhhmmss
DueDate
ISO8601DueDate	format = yyyyMMddhhmmss
DocumentURL
Publisher *
PublicationType *
PublicationDate *
PublicationPlace *
Volume *
Issue *
Edition *
Issn *
Issn2 *
Isbn *
Isbn2 *
Ismn *
PagesRequested *
DeliveryDate *
ISO8601DeliveryDate	format = yyyyMMddhhmmss
AllowRenew:	true / false
AllowCancel	true / false
RequestStatus
RequestStatusDate
ISO8601RequestStatusDate	format = yyyyMMddhhmmss
ExceptionCodeDesc

Note: The fields marked with an asterisk are included in the response for 'multiple requests' if {$full record=1}. All fields are included in the response for a single request.

The following request statuses may be returned:

ENTERED
IN_PROCESS
ANNULLATO
UNFILLED
SHIPPED
ARTICLE_SENT
ON_LOAN
OVERDUE
COMPLETE
UNKNOWN

Authorization id

Both services first validate the authorization id. If the authorization id is invalid then the following response is returned:

{
"AuthorizationState": {
"AuthorizationId": "YkbOGfGv6hKLefABkWJP2yYlI8",
"State": false
}
}

Error messages

The following problem codes and messages may be returned

Codice	Tipo	Messaggio
PUBQR004	Pubblico	No result for query
PUBQR008	Pubblico	Missing myRequest query parameters
PUBQR009	Pubblico	Unsupported myRequest query parameter
PUBAZ003	Pubblico	Proctor - missing parameters for validating authorization
PRIQR001	Privato	Internal query request error
PRIDA001	Privato	Internal data access error
PRIAZ001	Privato	Internal authorization error

Esempio

The following is a sample response for an unsuccessful query:

{
"Problem": {
"Code": "PUBQR004",
"Message": "No result for query"
}
}