Get OAI configuration
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "transformer": "string",
- "repositoryName": "string",
- "baseURL": "string",
- "adminEmail": "string"
}
Update OAI configuration.
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
transformer | string OAI server response transformer invocation: 'moduleId<::function>' where <::function> is optional |
repositoryName | string OAI repository name |
baseURL | string OAI repository base URL |
adminEmail | string OAI repository admin email |
{- "transformer": "string",
- "repositoryName": "string",
- "baseURL": "string",
- "adminEmail": "string"
}
Create match key
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
id required | string match key identifier |
matcher | string matcher module invocation: 'moduleId<::function>' where <::function> is optional |
method | string Deprecated DEPRECATED: use 'matcher' instead |
params | object Deprecated DEPRECATED: use 'matcher' instead |
update | string Enum: "ingest" "manual" ingest: update when records are ingested, manual: update only when initialize is called |
{- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
{- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
Get match key configurations
count | string Default: "none" Enum: "exact" "none" control of counting in queries |
limit | integer >= 0 Default: 10 Limit the number of elements returned in the response |
query | string CQL query |
offset | integer >= 0 Default: 0 Skip over number of elements (default is first element) |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "matchKeys": [
- {
- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
], - "resultInfo": {
- "totalRecords": 0,
- "diagnostics": [
- {
- "message": "string"
}
], - "facets": [
- {
- "facetValues": [
- {
- "count": 0,
- "value": null
}
], - "type": "string"
}
]
}
}
Get match key configuration
id required | string match key identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
Update match key configuration.
id required | string match key identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
id required | string match key identifier |
matcher | string matcher module invocation: 'moduleId<::function>' where <::function> is optional |
method | string Deprecated DEPRECATED: use 'matcher' instead |
params | object Deprecated DEPRECATED: use 'matcher' instead |
update | string Enum: "ingest" "manual" ingest: update when records are ingested, manual: update only when initialize is called |
{- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
Recalculate match key across all records.
id required | string match key identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "totalRecords": 0,
- "clustersTotal": 0,
- "matchValuesPerCluster": { },
- "recordsPerCluster": { },
- "recordsPerClusterSample": { }
}
Get statistics for match key configuration
id required | string match key identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "totalRecords": 0,
- "clustersTotal": 0,
- "matchValuesPerCluster": { },
- "recordsPerCluster": { },
- "recordsPerClusterSample": { }
}
Create a new code module
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
id required | string local identifier of the module, name |
type | string Enum: "jsonpath" "javascript" type of the module' |
url | string HTTP URL of the module e.g GitHub url, required if no 'script' specified |
function | string Deprecated DEPRECATED: do not use, specify function during invocation |
script | string inline contents of the code module |
{- "id": "string",
- "type": "jsonpath",
- "url": "string",
- "function": "string",
- "script": "string"
}
{- "id": "string",
- "type": "jsonpath",
- "url": "string",
- "function": "string",
- "script": "string"
}
Retrieve all code modules
count | string Default: "none" Enum: "exact" "none" control of counting in queries |
limit | integer >= 0 Default: 10 Limit the number of elements returned in the response |
query | string CQL query |
offset | integer >= 0 Default: 0 Skip over number of elements (default is first element) |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "modules": [
- {
- "id": "string",
- "type": "jsonpath",
- "url": "string",
- "function": "string",
- "script": "string"
}
], - "resultInfo": {
- "totalRecords": 0,
- "diagnostics": [
- {
- "message": "string"
}
], - "facets": [
- {
- "facetValues": [
- {
- "count": 0,
- "value": null
}
], - "type": "string"
}
]
}
}
Retrieve a code module by id
id required | string code module identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "id": "string",
- "type": "jsonpath",
- "url": "string",
- "function": "string",
- "script": "string"
}
Update code module by id
id required | string code module identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
id required | string local identifier of the module, name |
type | string Enum: "jsonpath" "javascript" type of the module' |
url | string HTTP URL of the module e.g GitHub url, required if no 'script' specified |
function | string Deprecated DEPRECATED: do not use, specify function during invocation |
script | string inline contents of the code module |
{- "id": "string",
- "type": "jsonpath",
- "url": "string",
- "function": "string",
- "script": "string"
}
Create source.
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
id required | string <uuid> source identifier |
name | string method |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
Get sources.
limit | integer >= 0 Default: 10 Limit the number of elements returned in the response |
query | string CQL query |
offset | integer >= 0 Default: 0 Skip over number of elements (default is first element) |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "sources": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
], - "resultInfo": {
- "totalRecords": 0,
- "diagnostics": [
- {
- "message": "string"
}
], - "facets": [
- {
- "facetValues": [
- {
- "count": 0,
- "value": null
}
], - "type": "string"
}
]
}
}
Get source.
id required | string <uuid> source identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "id": "string",
- "matcher": "string",
- "method": "string",
- "params": { },
- "update": "ingest"
}
Create ingest job
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
sourceId required | string Source identifier |
autoRollBackTimeout | integer Timeout in seconds |
{- "sourceId": "string",
- "autoRollBackTimeout": 0
}
{- "sourceId": "string",
- "autoRollBackTimeout": 0
}
Put records for job.
id required | string <uuid> ingest job identifier. |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
localId required | string Local identifier |
delete | boolean If true, record is deleted. Default: false |
payload | object Payload in JSON |
[- {
- "localId": "string",
- "delete": true,
- "payload": { }
}
]
[- {
- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "matchKeys": { }
}
]
Get ingest job information.
id required | string <uuid> ingest job identifier. |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "autoRollBackTimeout": 0
}
Finish ingest job with either rollback of commit.
id required | string <uuid> ingest job identifier. |
commit | boolean Default: false whether to commit |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
Upload MARC binary and MARCXML records.
sourceId required | string source identifier (library ID) |
sourceVersion | integer Default: 1 source version |
fileName | string file name of the uploaded file (for non multipart upload) |
localIdPath | string JSON-path for where local identifier is fetched from |
xmlFixing | boolean Default: false attempt to fix XML input by replacing invalid chars |
raw | boolean Default: false only calculate size |
ingest | boolean Default: true ingest records after processing files |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
X-Okapi-Permissions | string A JSON array with client permissions |
records | string <binary> |
{- "property1": {
- "processed": 0,
- "ignored": 0,
- "inserted": 0,
- "updated": 0,
- "deleted": 0
}, - "property2": {
- "processed": 0,
- "ignored": 0,
- "inserted": 0,
- "updated": 0,
- "deleted": 0
}
}
Get records that satisfy CQL query with fields localId, sourceId, globalId.
count | string Default: "none" Enum: "exact" "none" control of counting in queries |
limit | integer >= 0 Default: 10 Limit the number of elements returned in the response |
query | string CQL query |
offset | integer >= 0 Default: 0 Skip over number of elements (default is first element) |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "items": [
- {
- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "localId": "string",
- "sourceId": "string",
- "payload": { }
}
], - "resultInfo": {
- "totalRecords": 0,
- "diagnostics": [
- {
- "message": "string"
}
], - "facets": [
- {
- "facetValues": [
- {
- "count": 0,
- "value": null
}
], - "type": "string"
}
]
}
}
Create or update records.
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
sourceId required | string Source identifier | ||||||
sourceVersion | integer Source version | ||||||
required | Array of objects (ingestRecordChunk) Ingest job records chunk | ||||||
Array
|
{- "sourceId": "string",
- "sourceVersion": 0,
- "records": [
- {
- "localId": "string",
- "delete": true,
- "payload": { }
}
]
}
[- {
- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "matchKeys": { }
}
]
Get record with global identifier.
globalId required | string <uuid> global identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "localId": "string",
- "sourceId": "string",
- "payload": { }
}
Get clusters based on matchkeyid. Query is CQL with the following fields supported: matchValue, clusterId, globalId, localId, sourceId, sourceVersion.
count | string Default: "none" Enum: "exact" "none" control of counting in queries |
limit | integer >= 0 Default: 10 Limit the number of elements returned in the response |
matchkeyid required | string Match key configuration identifier |
query | string CQL query |
offset | integer >= 0 Default: 0 Skip over number of elements (default is first element) |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "items": [
- {
- "clusterId": "a3d24843-7014-4490-bdd3-b7cb39b400c8",
- "datestamp": "2019-08-24",
- "records": [
- {
- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "localId": "string",
- "sourceId": "string",
- "payload": { }
}
], - "matchKeys": [
- "string"
]
}
], - "resultInfo": {
- "totalRecords": 0,
- "diagnostics": [
- {
- "message": "string"
}
], - "facets": [
- {
- "facetValues": [
- {
- "count": 0,
- "value": null
}
], - "type": "string"
}
]
}
}
Update cluster timestamps. CQL must specify at least matchkeyId and sourceId. The sourceVersion and clusterId are optional.
query | string CQL query |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "count": 0
}
Get cluster by identifier
clusterId required | string <uuid> cluster identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "clusterId": "a3d24843-7014-4490-bdd3-b7cb39b400c8",
- "datestamp": "2019-08-24",
- "records": [
- {
- "globalId": "acafdba6-01a5-49f1-8345-02e5e658483c",
- "localId": "string",
- "sourceId": "string",
- "payload": { }
}
], - "matchKeys": [
- "string"
]
}
OAI service
identifier | string OAI identifier. Required for verb=GetRecord |
from | string For verb=ListRecords limit to this "from" date-time. |
limit | integer >= 1 Default: 1000 OAI list records/identifiers returns resumptionToken if this is met |
until | string For verb=ListRecords limit to this "until" date-time. |
resumptionToken | string For verb=ListRecords, use this resumption token |
set | string OAI set. Required for verb=ListRecords |
verb | string OAI verb |
metadataPrefix | string OAI metadataPrefix. Required for verb=ListRecords|GetRecord |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
Create OAI PMH client job
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
from | string OAI PMH from date |
id required | string OAI PMH Client identifier |
headers | object Additional HTTP headers to be used against OAI server with keys and string values |
metadataPrefix | string OAI PMH metadata prefix |
params | object Additional query parameters with keys and string values |
resumptionToken | string OAI PMH resumption token |
numberRetries | integer Number of retries for temporary errors before giving up (default 3) |
waitRetries | integer Number of seconds to wait between retries (default 10) |
set | string OAI PMH set as returned in verb=ListSets |
sourceId required | string Source identifier used for storing records |
sourceVersion | integer Source version used for storing records |
until | string OAI PMH until date |
url required | string OAI PMH server prefix so that PREFIX?verb=.. works |
xmlFixing | boolean Attempt to fix malformed server response by removing invalid chars |
{- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}
{- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}
Get all OAI PMH client jobs
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}
Get OAI-PMH client
id required | string OAI-PMH client identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}
Update OAI-PMH client
id required | string OAI-PMH client identifier |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
from | string OAI PMH from date |
id required | string OAI PMH Client identifier |
headers | object Additional HTTP headers to be used against OAI server with keys and string values |
metadataPrefix | string OAI PMH metadata prefix |
params | object Additional query parameters with keys and string values |
resumptionToken | string OAI PMH resumption token |
numberRetries | integer Number of retries for temporary errors before giving up (default 3) |
waitRetries | integer Number of seconds to wait between retries (default 10) |
set | string OAI PMH set as returned in verb=ListSets |
sourceId required | string Source identifier used for storing records |
sourceVersion | integer Source version used for storing records |
until | string OAI PMH until date |
url required | string OAI PMH server prefix so that PREFIX?verb=.. works |
xmlFixing | boolean Attempt to fix malformed server response by removing invalid chars |
{- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}
Get OAI PMH client status
id required | string OAI-PMH client identifier; "_all" for all clients |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |
{- "items": [
- {
- "config": {
- "from": "string",
- "id": "string",
- "headers": { },
- "metadataPrefix": "string",
- "params": { },
- "resumptionToken": "string",
- "numberRetries": 0,
- "waitRetries": 0,
- "set": "string",
- "sourceId": "string",
- "sourceVersion": 0,
- "until": "string",
- "url": "string",
- "xmlFixing": true
}, - "error": "string",
- "lastActiveTimestamp": "2019-08-24T14:15:22Z",
- "lastRecsPerSec": 0,
- "lastRunningTime": "string",
- "lastTotalRecords": 0,
- "lastStartedTimestamp": "2019-08-24T14:15:22Z",
- "status": "idle",
- "totalRecords": 0,
- "totalDeleted": 0,
- "totalInserted": 0,
- "totalUpdated": 0,
- "totalRequests": 0
}
]
}
SRU service
query | string CQL query |
startRecord | integer >= 1 Default: 1 SRU start Record (first record is 1) |
maximumRecords | integer >= 0 Default: 10 SRU maximum records |
version | string SRU version |
operation | string SRU operation, such as searchRetrieve |
recordSchema | string SRU record schema |
X-Okapi-Tenant | string Okapi Tenant |
X-Okapi-Token | string Okapi Token |
X-Okapi-Url | string Okapi URL |