Introduction
These API specifications are automatically generated from each repository’s RAML files, and specify how client modules may access the functionality provided by these modules. See usage notes below.
- view-1: Uses pop-up windows for each method and endpoint.
- view-2: Uses one-page view to everything.
This list of modules is sorted into functional groups.
Login
Handling the login process.
mod-login
| Source | ||
|---|---|---|
| login.raml | view-1 | view-2 |
mod-login-saml
| Source | ||
|---|---|---|
| saml-login.raml | view-1 | view-2 |
mod-password-validator
| Source | ||
|---|---|---|
| password-validator.raml | view-1 | view-2 |
| validator-registry.raml | view-1 | view-2 |
mod-permissions
| Source | ||
|---|---|---|
| tenantPermissions.raml | view-1 | view-2 |
| permissions.raml | view-1 | view-2 |
Users
Information about users.
mod-users-bl
| Source | ||
|---|---|---|
| mod-users-bl.raml | view-1 | view-2 |
mod-users
mod-patron
| Source | ||
|---|---|---|
| patron.raml | view-1 | view-2 |
edge-patron
| Source | ||
|---|---|---|
| edge-patron.raml | view-1 | view-2 |
mod-feesfines
Codex
The FOLIO Codex.
mod-codex-mux
| Source * | ||
|---|---|---|
| codex.raml | view-1 | view-2 |
| codex-instances-sources.raml | view-1 | view-2 |
| codex-packages.raml | view-1 | view-2 |
mod-codex-inventory
| Source * | ||
|---|---|---|
| codex.raml | view-1 | view-2 |
mod-codex-ekb
| Source * | ||
|---|---|---|
| codex.raml | view-1 | view-2 |
| codex-instances-sources.raml | view-1 | view-2 |
| codex-packages.raml | view-1 | view-2 |
mod-codex-mock
| Source * | ||
|---|---|---|
| codex.raml | view-1 |
Inventory and circulation
Inventory instances, items, and circulation.
mod-circulation
mod-circulation-storage
mod-inventory
| Source | ||
|---|---|---|
| inventory.raml | view-1 | view-2 |
| inventory-batch.raml | view-1 | view-2 |
| inventory-config.raml | view-1 | view-2 |
| inventory-event-handlers.raml | view-1 | view-2 |
| isbn.raml | view-1 | view-2 |
mod-inventory-storage
mod-kb-ebsco-java
mod-oai-pmh
| Source | ||
|---|---|---|
| oai-pmh.raml | view-1 | view-2 |
edge-oai-pmh
| Source | ||
|---|---|---|
| edge-oai-pmh.raml | view-1 | view-2 |
mod-marccat
| Source | ||
|---|---|---|
| marccat.raml | view-1 | view-2 |
Resource management
ERM, licenses, usage statistics.
mod-erm-usage
| Source | ||
|---|---|---|
| aggregatorsettings.raml | view-1 | view-2 |
| counterreports.raml | view-1 | view-2 |
| usagedataproviders.raml | view-1 | view-2 |
mod-erm-usage-harvester
| Source | ||
|---|---|---|
| harvester.raml | view-1 | view-2 |
| periodic.raml | view-1 | view-2 |
| start.raml | view-1 | view-2 |
mod-licenses
| Source | ||
|---|---|---|
| licenses.raml | view-1 | view-2 |
mod-finc-config
Finance and orders
Finance, orders, organizations.
mod-finance
mod-finance-storage
mod-invoice
mod-invoice-storage
mod-orders
| Source | ||
|---|---|---|
| acquisitions-units.raml | view-1 | view-2 |
| configuration.raml | view-1 | view-2 |
| order.raml | view-1 | view-2 |
| titles.raml | view-1 | view-2 |
mod-orders-storage
edge-orders
| Source | ||
|---|---|---|
| edge-orders.raml | view-1 | view-2 |
mod-organizations-storage
mod-gobi
| Source | ||
|---|---|---|
| gobi.raml | view-1 | view-2 |
Notifications
Assembling and sending notifications.
mod-notify
| Source | ||
|---|---|---|
| notify.raml | view-1 | view-2 |
| patron-notice.raml | view-1 | view-2 |
mod-event-config
| Source | ||
|---|---|---|
| event_config.raml | view-1 | view-2 |
mod-email
| Source | ||
|---|---|---|
| email.raml | view-1 | view-2 |
| delayedTasks.raml | view-1 | view-2 |
mod-sender
| Source | ||
|---|---|---|
| sender.raml | view-1 | view-2 |
mod-pubsub
| Source | ||
|---|---|---|
| pubSub.raml | view-1 | view-2 |
Data import and export
Importing and loading and exporting various data.
mod-data-import
| Source | ||
|---|---|---|
| dataImport.raml | view-1 | view-2 |
mod-data-import-converter-storage
| Source | ||
|---|---|---|
| data-import-converter-storage.raml | view-1 | view-2 |
| form-configs-storage.raml | view-1 | view-2 |
mod-data-loader
| Source | ||
|---|---|---|
| loader.raml | view-1 |
mod-data-export
| Source | ||
|---|---|---|
| dataExport.raml | view-1 | view-2 |
| dataExport-FileDefinition.raml | view-1 | view-2 |
mod-source-record-manager
| Source | ||
|---|---|---|
| change-manager.raml | view-1 | view-2 |
| change-manager-handlers.raml | view-1 | view-2 |
| mapping-rules-provider.raml | view-1 | view-2 |
| metadata-provider.raml | view-1 | view-2 |
mod-source-record-storage
| Source | ||
|---|---|---|
| source-record-storage.raml | view-1 | view-2 |
| source-record-storage-batch.raml | view-1 | view-2 |
| source-record-storage-handlers.raml | view-1 | view-2 |
mod-user-import
| Source | ||
|---|---|---|
| import.raml | view-1 | view-2 |
Utilities and tools
Notes, tags, calendar, etc.
mod-notes
| Source | ||
|---|---|---|
| link.raml | view-1 | view-2 |
| note.raml | view-1 | view-2 |
| types.raml | view-1 | view-2 |
mod-tags
| Source | ||
|---|---|---|
| tags.raml | view-1 | view-2 |
mod-calendar
| Source | ||
|---|---|---|
| calendar.raml | view-1 | view-2 |
mod-template-engine
| Source | ||
|---|---|---|
| template-engine.raml | view-1 | view-2 |
mod-custom-fields
| Source | ||
|---|---|---|
| custom-fields.raml | view-1 | view-2 |
mod-quick-marc
| Source | ||
|---|---|---|
| records-editor.raml | view-1 | view-2 |
Infrastructure
Gateway, raml-util, RMB, monitoring, etc.
okapi
| Source | ||
|---|---|---|
| okapi.raml | view-1 | view-2 |
raml
This is the shared RAML repository. Each module uses a certain version of this as their "raml-util" directory.
| Label | Source * | ||
|---|---|---|---|
| shared | jsonSchemas.raml | view-1 | view-2 |
| shared | ramls.raml | view-1 | view-2 |
| shared | tenant.raml | view-1 | view-2 |
| shared-codex | codex.raml | view-1 | view-2 |
| shared-codex | codex-instances-sources.raml | view-1 | view-2 |
| shared-codex | codex-packages.raml | view-1 | view-2 |
| tagged-record-example | users.raml | view-1 | view-2 |
raml-module-builder
| Source | ||
|---|---|---|
| admin.raml | view-1 | view-2 |
| jobs.raml | view-1 | view-2 |
| sample.raml | view-1 | view-2 |
mod-configuration
| Source | ||
|---|---|---|
| config.raml | view-1 | view-2 |
mod-audit
| Source | ||
|---|---|---|
| audit-data.raml | view-1 | view-2 |
mod-rtac
| Source | ||
|---|---|---|
| rtac.raml | view-1 | view-2 |
edge-rtac
| Source | ||
|---|---|---|
| edge-rtac.raml | view-1 | view-2 |
Other
Not yet grouped.
mod-courses
| Source | ||
|---|---|---|
| courses.raml | view-1 | view-2 |
Deprecated
Some old ones that have been renamed.
mod-vendors
Further information
Configuration
See explanation for how to configure the generation of API documentation of each back-end module.
Usage notes
-
The documents are generated by CI for each repository during the “merge to master” phase. So the documentation relates only to the current master branch.
-
Since August 2018 the generated documents are saved for each software version. So for mod-inventory-storage amend the URL of the generated documents to add the version number (major.minor), e.g.
mod-inventory-storage/12.5/... -
For repositories that are still using RAML-0.8 version, the “view-2” presentation is empty because the software that is used to generate that view only supports RAML-1.0 version.
-
NOTE: 2018-11-20: The “view-2” using the “plain” theme is available after each module’s next merge to master.
-
The asterisk
*denotes that this is a shared set of RAML files. The generated documents are for this module’s current raml-util, but the link to the source RAML file is to the head of the default branch of the shared “raml” repository.