PatronRenewBlocksGet
This method takes in a Patron ID and returns patron renewal blocks (if any). It also indicates whether the patron is allowed to renew (the blocks may be informational or actual blocks). It is a protected method and staff must authenticate before calling this method.
| GET | /protected/1/{AccessToken}/circulation/patron/{PatronID}/renewblocks |
Authorization required?
Yes
Protected?
Yes
URI Parameters
| Name |
Required |
Description/Notes |
|
PatronID |
Yes |
ID of patron. |
XML Elements Returned
The following XML elements are returned.
|
Name |
Description/Notes |
| PAPIErrorCode |
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 |
| PatronID | ID of patron |
| PatronName | Name of patron |
| BlockDescription | A description of why a patron may not be allowed to renew an item. |
| CanPatronRenew | A boolean value indicating whether the patron can renew an item. |
Result - Example 1
Copy
HTTP/1.1 200 OK
<RenewBlocksResult
xmlns:i="http://www.w3.org/2001/XMLSchemainstance">
<PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage/>
<Blocks>
<Block>
<PatronID>137096</PatronID>
<PatronName>Joseph, Sarah </PatronName>
<BlockDescription>This action is not permitted. Please contact the library regarding your account.</BlockDescription>
</Block>
</Blocks>
<CanPatronRenew>false</CanPatronRenew>
</RenewBlocksResult>
Result - Example 2
Copy
HTTP/1.1 200 OK
<CanPatronRenewResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage/>
<Blocks />
<CanPatronRenew >true</ CanPatronRenew>
</CanPatronRenewResult>