BibsPost
Import MARC records to create and overlay bibliographic records in Polaris. An import job is created for each post. By default, Polaris attempts to match the incoming 001 tag to an existing bibliographic record ID. If Polaris finds a match, it modifies the existing record. If Polaris doesn't find a match, it creates a new bibliographic record.
| POST |
/protected/1/{accesstoken}/bibs |
Authorization required?
Yes
Protected method?
Yes
URI Parameters
|
Name |
Required |
Description |
|
ImportProfileName |
No |
Import profile name. If not supplied the default is "PAPI default". |
| WorkstationID | No | Workstation identifier. |
XML Body Elements
Provided in the MARC 21 XML Schema from the Library of Congress, found here:
https://www.loc.gov/standards/marcxml/
XML Elements Returned
|
Name |
Description/Notes |
| PAPIErrorCode |
PAPI Error code: Negative values represent errors and are defined in Polaris API - Overview. 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. |
|
ImportJobID |
The background import job ID. |
Example
| https://localhost/REST/protected/v1/1033/100/1/bibs |
Body
|
<collection xmlns="http://www.loc.gov/MARC21/slim"> <record> <leader>00000nam a22000007i 4500</leader> <controlfield tag="001">1793091</controlfield> <controlfield tag="005">20240402112049.0</controlfield> <controlfield tag="008">211115t20212021nyuaf 000 f eng d</controlfield> <datafield tag="100" ind1="1" ind2=" "> <subfield code="a">Tarantino, Quentin</subfield> </datafield> <datafield tag="245" ind1="1" ind2="0"> <subfield code="a">Once upon a time in Hollywood</subfield> </datafield> </record> </collection> |
Return - Success
|
HTTP/1.1 200 OK <BibsPostResult> <PAPIErrorCode>0</PAPIErrorCode> <ErrorMessage i:nil="true" /> <ImportJobID>5814</ImportJobID> </BibsPostResult> |
Return - Failed
|
HTTP/1.1 200 OK <BibsPostResult> <PAPIErrorCode>-1001</PAPIErrorCode> <ErrorMessage>Bibliographic import profile name not found</ErrorMessage> <ImportJobID i:nil="true" /> </BibsPostResult> |