Making Requests
Less than to read
We recommend the use of Postman as a quick way to get started testing the changes that we’ve had to make due to Brexit.
If you are new to Postman, or would like further help getting started with it please see our guide here.
Changes to URLs
The new Brexit test environment has different URLs required during the authentication process as well as a different base URL used when making your requests.
When selecting the “Get New Access Token” option in postman you will require your client_id
, callback_url
and client_secret
from the new app registry, and also use the following URLs:
- Auth URL -
https://central.app.qa2.dev-sageone.com/oauth2/auth
- Access Token URL -
https://hsgq8xp9qf.execute-api.eu-west-1.amazonaws.com/qa2-token-api/token
Example Postman Get Access Token screen:
Authentication and application authorization
In order to authenticate, you will use the previously mentioned AWS credentials:
Username
: hxBERa9SKewC
Password
: A6_y8*9Tzj
However, the first time you go through the authentication process you will be required to grant permission for your application to access the businesses data, and at that point you will be required to enter your Sage ID and password set up during the previous steps.
Endpoints
Once you have successfully authenticated and retrieved a new access token you will need to use the base URL below appending the endpoint you would usually use:
- Base URL -
https://zsfvla7fqi.execute-api.eu-west-1.amazonaws.com/qa2/
Some Example request URLs:
- Contacts -
https://zsfvla7fqi.execute-api.eu-west-1.amazonaws.com/qa2/contacts
- Sales Invoices -
https://zsfvla7fqi.execute-api.eu-west-1.amazonaws.com/qa2/sales_invoices
What’s Next
Now that you are successfully up and running you can see our in-depth guide to all the Brexit changes: