====== VuFind APIs ======

The APIs documented on these pages are available on /api endpoint of the VuFind installation (e.g. http://localhost/vufind/api). There is a Swagger UI available for documentation and testing of the APIs on that endpoint. Each API requires proper permissions, so by default the APIs are not available to any user. The only practical way of granting the permissions at the moment is by IP address, such as:

  ; Search and Record API permissions.
  [api.SearchAndRecord]
  permission[] = access.api.Search
  permission[] = access.api.Record
  require = ANY
  ipRange[] = '127.0.0.1'
  ipRange[] = '::1'

The above would allow access only from localhost. All APIs support CORS with no origin limits and return data in JSON format. 

===== Swagger UI and Specification =====

There is a Swagger UI available with in-depth documentation on the /api endpoint, e.g. http://localhost/vufind/api. You can also access the Swagger specification directly at http://localhost/vufind/api?swagger.

The Swagger UI is driven by the specification, but it can also be used to create a client library for many programming languages. See http://swagger.io/swagger-codegen/ and http://petstore.swagger.io/ for more information and tools to do the job.

===== Available APIs =====

  * [[development:apis:search|Search API]]
  * [[development:apis:record|Record API]]
  * [[development:apis:index2search|Secondary Index Search API]]
  * [[development:apis:index2record|Secondary Index Record API]]
  * [[development:apis:admin|Admin API (only for clearing cache at the moment)]]