PatronTitleListGetTitles
Returns all titles, or a range of titles by position in the list, for a specified title list in the patron account.
| GET | /public/1/patron/{PatronBarcode}/patrontitlelistgettitles?list={list_id}&start Position={StartPosition}&endPosition={EndPosition} |
Authorization required?
Yes
URI Parameters
| Name |
Required |
Description/Notes |
| PatronBarcode | Yes | Barcode of patron. |
| list | Yes | Record ID of the list |
| StartPosition | No | Position in the list of the first title to return |
| EndPosition | No | Position in the list of the last title to return |
Note: If you find that a very large title list is not returned in its entirety, use the start_position and end_position parameters to have the list returned in smaller "chunks."
XML Elements Returned
The following XML elements are returned.
|
Name |
Description/Notes |
| PAPIErrorCode |
PAPI Error code: Negative values represent errors and are defined elsewhere. Note: On successful completion, the PAPI error code is populated with a positive integer representing the number of rows returned. |
| ErrorMessage | Error or information message |
Examples
Copy
http://localhost/PAPIService/REST/public/v1/1033/100/1/patron/21756003332022/patrontitlelistgettitles?list=3
http://localhost/PAPIService/REST/public/v1/1033/100/1/patron/21756003332022/patrontitlelistgettitles?list=3&startPosition=3&endPosition=8
Return - Success
Copy
Return - Success
HTTP/1.1 200 OK
<PatronTitleListGetTitlesResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage/>
<PatronTitleListTitleRows>
<PatronTitleListTitleRow>
<Position>1</Position>
<RecordID>9378</RecordID>
<Name>Quick & Easy Cooking for One [electronic resource]</Name>
<LocalControlNumber>995136</LocalControlNumber>
</PatronTitleListTitleRow>
<PatronTitleListTitleRow>
<Position>2</Position>
<RecordID>9379</RecordID>
<Name>Quick & Easy Cooking for One [electronic resource]</Name>
<LocalControlNumber>995136</LocalControlNumber>
</PatronTitleListTitleRow>
</PatronTitleListTitleRows>
</PatronTitleListGetTitlesResult>
Return - Failed
Copy
Return - Failed
HTTP/1.1 200 OK
<PatronTitleListGetTitlesResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<PAPIErrorCode>-1</PAPIErrorCode>
<ErrorMessage>Could not retrieve records because record-store '999' does not exist.</ErrorMessage>
<PatronTitleListTitleRows/>
</PatronTitleListGetTitlesResult>