REST API Intro
Updated 3 weeks ago
by
Stephan Hale
Getting started
To get started with Quinyx REST API, there are a few things you will need to know.
The framework used for authorisations to the REST API´s is Oauth2. More detailed information can be found here https://oauth.net/2/ .
The basic flow for authentication is that a user is given a:
- Client id - needs to be kept confidential
- Client secret - needs to be kept VERY confidential
- uuid - this is an identifier to be used in communication with Quinyx if needed
- Link to be able to generate a bearer token to be used for authorisations towards the REST API
- Token is valid for 60 minutes
Different client id/ client secrets is required for our different environments
Example
To obtain a bearer token a POST call is done towards https://api.quinyx.com/v2/oauth/token with the following configuration
Parameter settings (Params):
- Key = grant_type
- Value = client_credentials
Authorization
- Type = Basic Auth
- Username = Client id
- Password = Client secret
examples from Postman
Environments
RC
RC is our customer environment (Release Candidate) where you as a customer can access your data in a sandbox environment. It will contain your customer data from the production environment up until last month. The data in this environment gets updated on the evening of the 1st of each month with data from production and that will overwrite all changes made in the RC environment.
Api-docs : https://api-rc.quinyx.com/v2/docs
Classic Web Interface: https://rc.quinyx.com
Neo Web Interface: https://web-rc.quinyx.com
Production
This is the production (live) environment which is reached through
Api-docs : https://api.quinyx.com/v2/docs
Classic Web Interface: https://app.quinyx.com
Neo Web Interface: https://web.quinyx.com
Programs for testing
For testing and troubleshooting we suggest using SoapUI or Postman, our example queries and responses are from Postman. If in contact with Quinyx always attach the request and response in .xml , .txt or similar format.
Limitations
The following limitations currently apply:
- You are not allowed to use more than 5 concurrent requests (eg. running more than 5 threads simultaneously per unique customer regardless of endpoint).
- When using GET/calculated-variables/{extCalculatedVarId} we do not currently support the retrieval of calculated variables that include standard variables in their calculation. This will be supported in a future version.
