Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Copyright (C) 2018-2019 The Open Library Foundation

This software is distributed under the terms of the Apache License, Version 2.0. See the file "LICENSE" for more information.


The purpose of this edge API is to bridge the gap between 3rd party purchasing systems/vendors and FOLIO. More specifically, the initial implementation was built with EBSCO's GOBI (Global Online Bibliographic Interface) service in mind.


See edge-common for a description of the security model.

Required Permissions

Institutional users should be granted the following permissions in order to use this edge API:

  • gobi.all


See edge-common for a description of how configuration works.

Api configuration can be specified by api_config system property as URL or path.

By default /reources/api_configuration.json will be used.

Api Configuration format:

Property Example Description
type GOBI Type of the system
pathPattern /orders/validate URL Path for mapping
method POST HTTP method for mapping
proxyMehtod POST HTTP method for proxy
proxyPath /gobi/validate Path for proxy

Example of api mapping content:

  "routing": [
      "type": "GOBI",
      "method": "POST",
      "pathPattern": "/orders/validate",
      "proxyPath": "/gobi/validate"
      "type": "GOBI",
      "method": "GET",
      "pathPattern": "/orders/validate",
      "proxyMethod": "POST",
      "proxyPath": "/gobi/validate"

Error processing

Priority of return types if the client accepts more than one type:

  1. application/json
  2. application/xml
  3. text/plain default : application/xml


Accept Header Error Format
application/json application/json
application/xml application/xml
text/plain text/plain
/ application/xml
text/plain,application/json application/json
application/json,application/xml application/json
application/xml,application/json application/json
text/plain,application/xml application/xml
other application/xml

Additional information

Issue tracker

See project EDGORDERS at the FOLIO issue tracker.

Other documentation

Other modules are described, with further FOLIO Developer documentation at