Using Spiro's API

Follow

Requesting Access

In order to use Spiro’s API, you must have a valid access token, provided by Spiro.  To request a token, email [email protected] with your request, and make sure to include a redirect URI (must be https/ssl).  Spiro will send you a client ID, client secret, and authentication URL.

Follow the authentication URL, and approve access using your username and password: http://engine.spiro.ai/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=

 

Once you are there you have to sign in and authorize access.
Screen_Shot_2018-07-09_at_11.42.45_AM.png

You will be redirected to your redirect URI, which will now contain an authorization code, sent by Spiro. https://YOUR_REDIRECT_URI?code=18768d576dc182906bc1e030871bf79bf9da99a38c607c3ffbc60b3796b2f9d2

From there you can request the access token via the following endpoint:  

Screen_Shot_2018-07-05_at_11.16.36_AM.png

You will receive the following response:

Screen_Shot_2018-07-05_at_12.09.30_PM.png

 

This diagram walks you through the process described above:

Screen_Shot_2018-07-09_at_12.02.21_PM.png

 

Using the API

Each tab on the left hand side of the API interface mirrors a class of features in Spiro.  Under each class of features, there is a list of endpoints that can be used to retrieve, create, update, or delete data via HTTP request protocol.  Clicking on the endpoint in the API interface opens a built in test development environment which specifies the URI, request method (GET, POST, DELETE, or PUT), and parameters.  Additionally, developers can actually call the resource example from the environment, and see an example request syntax and infrastructure in several programming languages. The API Reference can be found here.

 

Interested in Spiro for your team? Sign up for a demo today: spiro.ai/demo

Questions? Email [email protected]

 

 

Was this article helpful?
0 out of 0 found this helpful

Comments