mod-kb-ebsco-java API documentation version v1
https://github.com/folio-org/mod-kb-ebsco-java
mod-kb-ebsco-java
Implements the eholdings interface using EBSCO KB as backend.
Status
Gives status of currently set KB configuration.
Gives status of currently set KB configuration.
get /eholdings/status
Gives status of currently set KB configuration.
HTTP status code 200
Body
Media type: application/vnd.api+json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Status Response Schema",
"description": "Status Response Schema using JSON API",
"type": "object",
"javaType": "org.folio.rest.jaxrs.model.ConfigurationStatus",
"additionalProperties": false,
"properties": {
"data": {
"type": "object",
"javaType": "org.folio.rest.jaxrs.model.StatusData",
"description": "Status Data",
"$ref": "statusData.json"
},
"jsonapi": {
"type": "object",
"description": "JSON API Version",
"$ref": "../jsonapi.json"
}
}
}
Example:
{
"data": {
"id": "status",
"type": "statuses",
"attributes": {
"isConfigurationValid": true
}
},
"jsonapi": {
"version": "1.0"
}
}
HTTP status code 500
Internal server error
Body
Media type: text/plain
Type: any
Example:
Internal server error, contact administratorCache
Invalidate configuration cache for tenant
Run load holdings job
Run load holdings job.
post /eholdings/loading/kb-credentials
Run load holdings job.
Headers
- Content-Type: required(string)
Example:
application/json
HTTP status code 204
No Content
HTTP status code 409
Process of loading holdings is already running
Body
Media type: text/plain
Type: any
Example:
Process of loading holdings is already runningHTTP status code 500
Internal server error
Body
Media type: text/plain
Type: any
Example:
Internal server error, contact administratorRun load holdings job by credentials id.
post /eholdings/loading/kb-credentials/{id}
Run load holdings job by credentials id.
URI Parameters
- id: required(string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
Headers
- Content-Type: required(string)
Example:
application/json
HTTP status code 204
No Content
HTTP status code 404
Not Found
Body
Media type: application/vnd.api+json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Error Response Schema",
"description": "Error Response Schema for JSON API",
"javaType": "org.folio.rest.jaxrs.model.JsonapiError",
"type": "object",
"additionalProperties": false,
"properties": {
"errors": {
"type": "array",
"description": "Error Response List",
"items": {
"type": "object",
"$ref": "jsonapiErrorResponse.json"
}
},
"jsonapi": {
"type": "object",
"description": "JSON API Version",
"$ref": "jsonapi.json"
}
}
}
Example:
{
"errors": [
{
"title": "KB credentials with id '99999999-9999-9999-9999-999999999999' not found"
}
],
"jsonapi": {
"version": "1.0"
}
}
HTTP status code 409
Process of loading holdings is already running
Body
Media type: text/plain
Type: any
Example:
Process of loading holdings is already runningHTTP status code 500
Internal server error
Body
Media type: text/plain
Type: any
Example:
Internal server error, contact administratorGet current status of load holdings job.
get /eholdings/loading/kb-credentials/{id}/status
Get current status of load holdings job.
URI Parameters
- id: required(string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
Headers
- Content-Type: required(string)
Example:
application/json
HTTP status code 200
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Holdings Loading Status Schema",
"description": "Holdings Loading Status Schema",
"javaType": "org.folio.rest.jaxrs.model.HoldingsLoadingStatus",
"type": "object",
"additionalProperties": false,
"properties": {
"data": {
"type": "object",
"description": "Status data",
"$ref": "loadHoldingsStatusData.json"
},
"jsonapi": {
"type": "object",
"description": "version of json api",
"$ref": "../jsonapi.json"
}
},
"required": [
"data",
"jsonapi"
]
}
Example:
{
"data": {
"type": "status",
"attributes": {
"credentialsId": "99999999-9999-9999-9999-999999999999",
"started": "1999-12-31 14:59:59",
"finished": "1999-12-31 16:30:47",
"totalCount": 1234,
"status": {
"name": "Completed"
}
}
},
"jsonapi": {
"version": "1.0"
}
}
HTTP status code 404
Not Found
Body
Media type: application/vnd.api+json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Error Response Schema",
"description": "Error Response Schema for JSON API",
"javaType": "org.folio.rest.jaxrs.model.JsonapiError",
"type": "object",
"additionalProperties": false,
"properties": {
"errors": {
"type": "array",
"description": "Error Response List",
"items": {
"type": "object",
"$ref": "jsonapiErrorResponse.json"
}
},
"jsonapi": {
"type": "object",
"description": "JSON API Version",
"$ref": "jsonapi.json"
}
}
}
Example:
{
"errors": [
{
"title": "KB credentials with id '99999999-9999-9999-9999-999999999999' not found"
}
],
"jsonapi": {
"version": "1.0"
}
}
HTTP status code 500
Internal server error
Body
Media type: text/plain
Type: any
Example:
Internal server error, contact administrator