**New Developers Working Group**
====== Calling APIs ======


===== Examples of Using Specific APIs =====

==== Get an Auth Token ====

An Auth Token is needed for many of the other API calls.

<nowiki>https://<domain>/osrf-gateway-v1?service=open-ils.auth&method=open-ils.auth.login&param={"username":"<user name>","password":"<password>"}</nowiki>


==== Carousel API ====

Retrieve carousel IDs by passing an org ID:

<nowiki>https://<domain>/osrf-gateway-v1?service=open-ils.actor&method=open-ils.actor.carousel.retrieve_by_org&param=<org id></nowiki>

Retrieve contents of a carousel by passing a carousel ID:

<nowiki>https://<domain>/osrf-gateway-v1?service=open-ils.actor&method=open-ils.actor.carousel.get_contents&param=<carousel id></nowiki>

===== Things to add to this page: =====

  * Info from: https://docs.evergreen-ils.org/eg/docs/latest/integrations/web_services.html
  * Link to Galen's Evergreen Conference presentation
  * Description of each of the established APIs and how to call them
  * Specs currently under review for RESTful API work - https://yeti.equinoxoli.org/dev/public/techspecs/restful_api_spec_202312.pdf