SynchTasksPullMARCData

Writes information about a title available in a 3rd party system. This is used as a trigger for a call to a 3rd party vendor API to retrieve an XML MARC record for a particular unique ID. This method should only be used if a 3rd party vendor has a corresponding API with a method that allows pulling MARC record data on a record-by-record basis.

  PUT /protected/1/{AccessToken}/synch/tasks/pullMARCData  

Authorization required?

Yes

Query String Parameters

Name

Value

Required

Description/Notes

wsid

>0

No

ID of workstation calling this method

userid

>0

No

ID of user calling this method (not patron ID)

Request Body XML

Important: XML elements must be in the order shown below.

Name

Description/Notes

VendorID Free text string. Consult with Polaris.
VendorContractID Free text string. Consult with Polaris.
UniqueRecordID The record ID in thrid-party system that identifies the title.

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

Example

Copy
http://[HOSTNAME]/PAPIService/REST/protected/v1/1033/100/1/[Access token]/synch/tasks/pullMARCData

Body

Copy
<SynchTasksPullMARCData>
    <VendorID>3M Cloud Library</VendorID>
    <VendorContractID>12345</VendorContractID>
    <UniqueRecordID>djhs8</UniqueRecordID>
</<SynchTasksPullMARCData>

Return - Success

Copy
Return - Success
HTTP/1.1 200 OK
<SynchTasksPullMARCResult
    xmlns:i="http://www.w3.org/2001/XMLSchemainstance">
    <PAPIErrorCode>0</PAPIErrorCode>
<ErrorMessage/></SynchTasksPullMARCResult>

Return - Failed

Copy
Return - Failed
HTTP/1.1 200 OK
<SynchTasksPullMARCResult
    xmlns:i="http://www.w3.org/2001/XMLSchemainstance">
    <PAPIErrorCode>-1</PAPIErrorCode>
    <ErrorMessage>Failure -general</ErrorMessage>
</SynchTasksPullMARCResult>