Edge ILL FOLIO API (1.0.0)

Edge API that proxies external client requests to the FOLIO mod-ill module. Endpoints mirror the mod-ill ill interface as declared in its module descriptor.

External

directoryEntry

External API access to directory entries

path Parameters
tenantId
required
string
Example: diku
query Parameters
slug
string

The directory entry the information is requested for

Responses

Response samples

Content type
application/json
{ }

iso18626

Receives an ISO18626 xml message

path Parameters
tenantId
required
string
Example: diku
Request Body schema: application/json
optional
object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "total_records": 1
}

statistics

Return the statistics

path Parameters
tenantId
required
string
Example: diku
query Parameters
symbol
string

The symbol in the form authority:symbol that the statistics are required for

Responses

Response samples

Content type
application/json
{ }

statusReport

Generates a brief status report about the service

path Parameters
tenantId
required
string
Example: diku

Responses

Response samples

Content type
application/json
{ }

PatronRequests

openURL

Get OpenURL for patron; Interprets an OpenUrl version 0.1 or 1.0

path Parameters
tenantId
required
string
Example: diku
query Parameters
object

Interprets an OpenURL version 0.1 or 1.0.

All parameters are accepted as query parameters and passed as a map containing:

Request Parameters (v1.0):

  • req.emailAddress: Requester email address
  • req.id: Requester ID

Referent Metadata Parameters (v1.0):

  • rft.artnum: Article number
  • rft.atitle: Article title
  • rft.au: Author
  • rft.aufirst: Author first name
  • rft.auinitl: Author initials (last)
  • rft.auinit: Author initials
  • rft.auinitm: Author initials (middle)
  • rft.aulast: Author last name
  • rft.bici: Book item and contribution identifier
  • rft.btitle: Book title
  • rft.coden: CODEN identifier
  • rft.creator: Creator
  • rft.edition: Edition
  • rft.eissn: Electronic ISSN
  • rft.genre: Genre/type of resource
  • rft.identifier.illiad: ILLiad identifier
  • rft.isbn: ISBN
  • rft.issn: ISSN
  • rft.issue: Issue number
  • rft.jtitle: Journal title
  • rft.epage: End page
  • rft.spage: Start page
  • rft.pages: Total pages
  • rft.part: Part
  • rft.date: Publication date
  • rft.place: Place of publication
  • rft.pub: Publisher
  • rft.quarter: Quarter
  • rft.sici: Serial Item and Contribution Identifier
  • rft.ssn: Serial Standard Number
  • rft.title: Title
  • rft.volume: Volume

Service Parameters (v1.0):

  • svc.neededBy: Service needed by date
  • svc.note: Service note
  • svc.pickupLocation: Service pickup location
  • svc.id: Service ID

Legacy Parameters (v0.1):

  • artnum: Article Number
  • aufirst: Author first name
  • auinitl: Author first initial
  • auinit: Author middle initial
  • aulast: Author last name
  • auinitm: Author middle initial
  • bici: BICI
  • bici: BICI
  • coden: Coden
  • genre: Genre
  • issn: ISSN
  • eissn: EISSN
  • isbn: ISBN
  • issue: Issue
  • epage: End Page
  • spage: Start Page
  • pages: Number Of Pages
  • part: Part
  • pickupLocation: Pickup location
  • date: Date
  • quarter: Quarter
  • ssn: SSN
  • sici: SICI
  • sharedIndexId: Shared index ID
  • title: Title
  • stitle: Abbreviated title
  • atitle: Article title
  • volume: Volume

Responses

Response samples

Content type
application/json
{ }

agreeCopyright

Agree to the copyright terms for the patron request

path Parameters
tenantId
required
string
Example: diku
patronRequestId
required
string
Example: 3c3f172c-6874-4c56-88e1-2350a3d90320

Responses

Response samples

Content type
application/json
{ }

fetchCopyright

Fetch the copyright details for the patron request

path Parameters
tenantId
required
string
Example: diku
patronRequestId
required
string
Example: 3c3f172c-6874-4c56-88e1-2350a3d90320

Responses

Response samples

Content type
application/json
{ }

viewDocument

View the document associated with the patron request

path Parameters
tenantId
required
string
Example: diku
patronRequestId
required
string
Example: 3c3f172c-6874-4c56-88e1-2350a3d90320

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "total_records": 1
}

TestDocumentDelivery

offer

Test document delivery offer

path Parameters
tenantId
required
string
Example: diku
Request Body schema: multipart/form-data
optional
systemId
required
string

The id of the institution an order is to be placed for

url
required
string

The url of the document delivery system

privateKey
required
string

The private key to use

offerReference
required
string

The reference for this document

documentTitle
string

The title for this offer

pin
required
string

The pin the user has to use to access the document

documentSecurityLevel
required
string
Enum: "DRM" "MARKED" "NONE" "SECURE"

The document security level

offerType
string
Enum: "DOCUMENT_STREAM" "URL"

The type of offer being made

attestationLevel
required
string
Value: "SIMPLE"

The attestation level

patronEmail
string

The patron's email

rawSourceMimeType
string

The mime type for the document

workflow
string

The workflow we want this offer to follow

file
string <binary>

The file to be uploaded, either this property of the rawSourceUrl property must be specified

Responses

Response samples

Content type
application/json
{ }

register

Test document delivery registration

path Parameters
tenantId
required
string
Example: diku
Request Body schema: multipart/form-data
optional
systemCode
required
string

The code of the institution we want to register

url
required
string

The url of the document delivery system

name
required
string

The name of the institution we are registering for

attestationLevel
required
string
Value: "SIMPLE"

The attestation level

Responses

Response samples

Content type
application/json
{ }

RemoteAction

perform

Perform Remote Action

path Parameters
tenantId
required
string
Example: diku
id
required
string

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ],
  • "total_records": 1
}