Loan In Service RESTful APIs - Release v0.8

Owned by Jessi Weithman
Apr 18, 2024
2 min read
Loan In Service Home

Brief Description

Error rendering macro 'excerpt-include' : No link could be created for 'Loan In Service Description and Assumptions'.
For a full description, visit the Service Description and Assumptions page.

Assumptions

For a complete list of assumptions, visit the Service Description and Assumptions page.

REST-based API

The Loan In Service offers a REST-based Application Programming Interface (API) to CRUD (create, read, update, and delete) operations on individual Loan In instances, plus list operations on multiple Loan In instances. These follow the Common model for CollectionSpace REST services.

Loan In CRUD+L services

Create an Loan In

Creates a new Loan In record. Assigns a unique, service-specified CollectionSpace ID (CSID) to that Loan In record. Follows standard Create model. See the documentation of the Loan In schema, below. Example:

POST /cspace-services/loansin HTTP/1.1
Read an Loan In

Reads an existing Loan In record, specified by its CollectionSpace ID (CSID). Follows standard Read model. See the documentation of the Loan In schema, below. Example:

GET /cspace-services/loansin/{id} HTTP/1.1
Update an Loan In

Updates an existing Loan In record, specified by its CollectionSpace ID (CSID). Follows standard Update model. See the documentation of the Loan In schema, below. Example:

PUT /cspace-services/loansin/{id} HTTP/1.1
Delete an Loan In

Deletes an existing Loan In record, specified by its CollectionSpace ID (CSID). Follows standard Delete model. Example:

DELETE /cspace-services/loansin/{id} HTTP/1.1
List Loan In instances

Lists existing Loan In records, with summary information for each. Follows standard List model. See the documentation of the Loan In list schema, below. Example:

GET /cspace-services/loansin HTTP/1.1

List supports query parameters for customizing list results, such as pagination controls, query filters, and sorting options. For example:

GET /cspace-services/loansin?pgSz=10 HTTP/1.1

List also supports query parameters for searching for matching records, including keyword search. For example:

GET /cspace-services/loansin?kw=foo&pgSz=10 HTTP/1.1

Loan In REST payload schemas

Loan In instance schema

The schemas below are severely abbreviated, and are thus illustrative. For a full list of the fields that may potentially be present in payloads when creating, updating, or reading individual Loan In records, please see the Loan In record schema for release 0.5.2.

Create and Update should use the following schema:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ns2:loansin-common xmlns:ns2="http://services.collectionspace.org/loanin">
    <loanInNumber>LI2010.05</loanInNumber>
    <lender>urn:cspace:org.collectionspace.demo:personauthority:name(TestPersonAuth):person:name(Linus Lender)'Linus Lender'</lender>
    <loanReturnDate>2011-09-23</loanReturnDate>
    <loanPurpose>To record content from Hellenistic Babylonian legal texts (cuneiform tablets), in conjunction with ongoing research effort.</loanPurpose>
    ...
</ns2:loansin-common>

Read will return the following schema:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ns2:loansin_common xmlns:ns2="http://collectionspace.org/services/loanin" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://collectionspace.org/services/loanin http://services.collectionspace.org/loanin/loansin_common.xsd">
    <loanInNumber>LI2010.05</loanInNumber>
    <lender>urn:cspace:org.collectionspace.demo:personauthority:name(TestPersonAuth):person:name(Linus Lender)'Linus Lender'</lender>
    <loanReturnDate>2011-09-23</loanReturnDate>
    <loanPurpose>To record content from Hellenistic Babylonian legal texts (cuneiform tablets), in conjunction with ongoing research effort.</loanPurpose>
    ...
</ns2:loansin-common>
Loan In list schema

List (and variants) will return the following schema. This schema includes the uri and csid fields to help facilitate access to individual records:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ns2:loansin-common-list xmlns:ns2="http://collectionspace.org/services/loanin">
  <loanin-list-item>
    <loanInNumber>LI2010.05</loanInNumber>
    <loanReturnDate>2011-09-23</loanReturnDate>
    <uri>/loansin/b59d0c6f-08f2-4fb5-b5f7</uri>
    <csid>b59d0c6f-08f2-4fb5-b5f7</csid>
  </loanin-list-item>
  ....
</ns2:loansin-common-list>