REST Authorisation
This page outlines the step to connect to Seller Center REST API, to authenticate, and generate token.
Please follow the below steps in either live or pre-prod.
Creating the authorisation application
1. Log in to Seller Center
2. Go to menu Settings - OAuth Applications
3. Click Add Application
4. Fill out the form by providing an Application Name and an Authorization redirect URL (any URL from your website) https://sellercenter.theiconic.com.au/ or https://sellercenter-preprod.theiconic.com.au/ will work, click Save and the application will be created.
Note.
The oAuth created here will be linked to your user email. If your Seller Center email login has the ability to switch between stores please be mindful of this, as it means the API call output will differ depending on which seller shop you are sitting in when logged in to Seller Center.
We recommend to create oAuth Application using email login of a user that does not have switching shop capabilities.
5. For additional info, to try out the requests in the created application, click edit
6. You will be able to see the Application ID and Application Secret, copy these values
Once you have the application ID and Secret, this information can be provided to you integration partner for use.
Instructions for sending requests through Postman
1. All requests have to use authentication parameters. API user needs to be authorized first and send access key as Authorization Bearer header in each request. To get the token:
The Authentication endpoints are:
Live = https://sellercenter-api.theiconic.com.au/oauth/client-credentials
Pre-prod (Test) = https://sellercenter-api-preprod.theiconic.com.au/oauth/client-credentials
Example of authentication endpoint below that will generate the token in the response.
The token is valid for 3600 seconds (1 hour) and the response contains this information: 'expires_in' field with 3600 value.
Then in the request enter the Bearer token
Testing the connection through the API documentation page
1. Go menu Help - API Documentation (which is this pre-prod API url or live API url)
2. Click the green Authorize button to display the pop-up box and enter your Application ID and Application Secret values here, and click Authorize.
3. On a successful connection, it will show the status Authorized.
4. To try a call, click the button Try it out
5. Fill in the required or optional parameters if needed then click Execute, response will be displayed