LAS/SCSB REST API Changes for Stage 2
REST APIs (which are a type of web API) involve requests and responses, not too unlike visiting a web page. You make a request to a resource stored on a server, and the server responds with the requested information. The protocol used to transport the data is HTTP. “REST” stands for Representational State Transfer.
SCSB REST API's consumed by LAS
Cancel Request:
No Change
Refile Item :
No Change
Accession :
Change as described below
Accession Batch :
Change, same as accession
Bulk Request:
No Changes
LAS REST API’s consumed by SCSB
Item status check:
No Change
Permanent Withdrawal – Direct :
No Change
Permanent Withdrawal – Indirect :
No Change
New REST APIs required from LAS
Heartbeat API : An API which will inform SCSB that LAS is up and running and ready to take requests
Request API: An API which will take the request and process at LAS side and send proper response
Heartbeat API:
Request Body:
{
"imsLocationCode": "RECAP"
}
Response Body : For success
{
"success": true
}
Response Body : For Failure
{
"screenMessage": "Invalid Location : RECAP".
"success": false
}
Request API :
a) Request Body for Retrieval Request ( Same as current ActiveMQ Message)
{"retrieveItem":{"ttitem":[{"itemBarcode":"33433107439345","itemStatus":null,"customerCode":"NA","destination":"QX","requestId":"729620","requestor":"22101008577603"}]}}
Response Body:
{"retrieveItem":{"ttitem":[{"itemBarcode":"33433107439345","itemStatus":null,"customerCode":"NA","destination":"QX","requestId":"729620","requestor":"22101008577603","errorCode":"","errorNote":""}]}}
b) Request Body for EDD Request ( Same as current ActiveMQ Message)
{"retrieveEDD":{"ttitem":[{"itemBarcode":"32101047104110","customerCode":"PA","requestId":729778,"requestor":"198572131","requestorFirstName":null,"requestorLastName":null,"requestorMiddleName":null,"requestorEmail":"zajicek@princeton.edu","requestorOther":null,"biblioTitle":"Toplumsal hareketler konus?uyor / yay?na haz?rlayan Leyla Sanl?.","biblioLocation":"HN656.5.Z9 S686 2003","biblioAuthor":" ","biblioVolume":null,"biblioCode":null,"articleTitle":"TOC, Chapter: Akkuyu Cernobil Olmadi","articleAuthor":"","articleVolume":", ","articleIssue":"","articleDate":null,"startPage":"95","endPage":"118","pages":null,"other":null,"priority":null,"notes":"","requestDate":null,"requestTime":null,"errorCode":null,"errorNote":null}]}}
Response Body:
{"retrieveEDD":{"ttitem":[{"itemBarcode":"32101047104110","customerCode":"PA","requestId":729778,"requestor":"198572131","requestorFirstName":null,"requestorLastName":null,"requestorMiddleName":null,"requestorEmail":"zajicek@princeton.edu","requestorOther":null,"biblioTitle":"Toplumsal hareketler konus?uyor \/ yay?na haz?rlayan Leyla Sanl?.","biblioLocation":"HN656.5.Z9 S686 2003","biblioAuthor":" ","biblioVolume":null,"biblioCode":null,"articleTitle":"TOC, Chapter: Akkuyu Cernobil Olmadi","articleAuthor":"","articleVolume":", ","articleIssue":"","articleDate":null,"startPage":"95","endPage":"118","pages":null,"other":null,"priority":null,"notes":"","requestDate":null,"requestTime":null,"errorCode":"","errorNote":""}]}}
API Changes for Accession and Accession Batch -
Accession Changes
Add one more variable
a: imsLocationCode
Values: 1) RECAP for ReCAP Warehouse
HD for Harvard Depository
{
"customerCode": "PA", // Customer code as stored in GFA LAS. This is used to identify the institution in SCSB.
"itemBarcode": "PULTST54340" // Item Barcode. Unique and common across SCSB, GFA LAS and partners' ILS.
"imsLocationCode": "RECAP"
}
Accession Batch
Add one more variable
a: imsLocationCode
Values: 1) RECAP for ReCAP Warehouse
HD for Harvard Depository
[{
"customerCode": "PA", // Customer code as stored in GFA LAS. This is used to identify the institution in SCSB.
"itemBarcode": "PULTST54340" // Item Barcode. Unique and common across SCSB, GFA LAS and partners' ILS.
"imsLocationCode": "RECAP"
},
{
"customerCode": "PA",
"itemBarcode": "PULTST54320"
"imsLocationCode": "RECAP"
},
{
"customerCode": "PA",
"itemBarcode": "PULTST54210"
"imsLocationCode": "RECAP"
}]