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

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

Body

<SynchTasksPullMARCData>

<VendorID>3M Cloud Library</VendorID>

<VendorContractID>12345</VendorContractID>

<UniqueRecordID>djhs8</UniqueRecordID>

</<SynchTasksPullMARCData>

Return - Success

HTTP/1.1 200 OK

<SynchTasksPullMARCResult

xmlns:i="http://www.w3.org/2001/XMLSchemainstance">

<PAPIErrorCode>0</PAPIErrorCode>

<ErrorMessage/>
</SynchTasksPullMARCResult>

Return - Failed

HTTP/1.1 200 OK

<SynchTasksPullMARCResult

xmlns:i="http://www.w3.org/2001/XMLSchemainstance">

<PAPIErrorCode>-1</PAPIErrorCode>

<ErrorMessage>Failure -general</ErrorMessage>

</SynchTasksPullMARCResult>