GETTING STARTED
Overview
This guide provides you with all the necessary information structured into simple steps, so that you can perform your first API request with Postman on our Kyriba API Playground.
Please refer to the video below to learn how to:
1. Create a support ticket to request access to our APIs.
2. Download a collection from Postman.
3. Import a collection.
4. Run your first request.
1. Create a Support Ticket to Request Access to our APIs
To request API credentials you should create a SUPPORT Ticket in the Developer Portal.
Please refer to the example below:
Next, after the review by Kyriba team, you will receive your credentials (client_id
/client_secret
) within 2 business days.
2. Download a Collection from Postman
In order to start testing, you can either use the Online version of Postman or download the Postman Desktop application. Please mind, online version has a restriction of 1000 API calls per user (monthly).
If you have already received your API credentials, you can verify if they are valid by following the steps presented in Test your Credentials guide, or you can use a Postman collection we have created for you. Just click on the Download Postman collection.
Once you are signed in to Postman, you proceed by selecting one of your Workspaces or by creating your Workspace from scratch, if necessary.
3. Import a Collection
Your next step is to click Import and then Upload Files which you have previously downloaded from the API CATALOG.
This will create your API collection in Postman.
In it you select the Get Token Request.
Then, proceed to the Authorization tab and make sure it is set to Basic Auth type. Replace Username and Password with respectfully client_id
/client_secret
that Kyriba has provided to you upon your request.
Next, in the Body tab make sure to set grant_type
.
Finally, you click on Send and then you receive an access Token.
The generated Token will be automatically stored in your Collection.
4. Run Your First Request
Now, you are authorized to interact with your API and start testing it.
You go to List accounts.
You click Send.
You receive the requested Accounts.
Congratulations! You have successfully performed your first Kyriba API request with Postman.
Note❗ If you received an Error message as a result of your call, please refer to HTTP Status Codes (access requires registration) guide for explanation.
Generate a Code Snippet in Postman
In order to be able to perform a request in your favorite programming language or framework, generate a code snippet.
Click "Code" icon on the right panel to open the Code snippet tab.
Here you can access the language you want, to correspond the call you have made with Postman.
For more information on code snippets generation, supported languages and frameworks click Generating client code page.