Synch_GetUpdatedAuthsPaged

This method returns a list of authority record IDs for records that have been updated since a specified date and time using a paging mechanism. The paged method allows the retrieval of the ID list in smaller packets.

A date, last record ID, and number of records to return must be specified. When retrieving the first set of records, the "lastid" of 0 forces the process to start at the beginning of the list. Then, when retrieving subsequent records, the "lastid" is used as the starting ID for the next request.

Important: This method provides information for authority records that have been added or updated in the Polaris ILS. The authority record must have a status of “final.” Updates to the following dates will cause records to appear on this list: Creation date, imported date, modified date, first use date, or record status date.

This method has a date and time parameter. If the time element is not specified, midnight of the day specified is assumed.

This method returns a generic AuthIDListGetResult XML structure (see below).

  GET /protected/1/{AccessToken}/synch/auths/updated/paged?updatedate=6/5/2017&
lastid=0&nrecs=10		  

Authorization required?

Yes

Protected method?

Yes

Query String Parameters

Name

Value

Required

Description/Notes

updatedate

YYYY-MM-DDTHH:MM:SS

Yes

Start date for record updates
lastid Use 0 when starting the retrieval process, otherwise, use the last retrieved ID.
No		  
nrecs Number of records to return Yes  

XML Elements 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

AuthIDListRows

List of item record IDs

AuthIDListRow

Container for data

AuthorityRecordID

The authority record ID

Example

Copy 
https://[HOSTNAME]/PAPIService/REST/protected/v1/1033/100/1/rGhOMQjR7MXZuJYREw6TQHPGsy1tlZPr/synch/auths/updated/paged?updatedate=6/5/2017&lastid=0&nrecs=10

Return

Copy 
HTTP/1.1 200 OK
<AuthIDListGetResult
    xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <PAPIErrorCode>0</PAPIErrorCode>
    <ErrorMessage/>
    <AuthIDListRows>
        <AuthIDListRow>
            <AuthorityRecordID>807343</AuthorityRecordID>
        </AuthIDListRow>
    </AuthIDListRows>
</AuthIDListGetResult>