API Key
This section explains the process of generating an API Key through both our UpStart Commerce Portal UI and APIs.
To interact and integrate with our Management APIs, the first step is to create an API Key. Follow the steps below to generate an API key through the UpStart Commerce Portal.
Access the UpStart Commerce Portal and log in using your credentials (Login and Password). If you are not registered, follow this link to create your sandbox account.
After successfully logging in, locate your Username in the top right corner. Click on the "Details" button. You will be directed to the "User Management" page.
Scroll down to the "API Key" section on the page and click on the "GENERATE KEY" button to initiate the key generation process.
Add a unique "Key Name" for your API and set the "Expiration Date", as required. Click on the "GENERATE KEY" button to proceed.
Upon successful generation, the form will display your Key Code. Click on the "Copy Key and Close" button to copy the API Key Code to your clipboard.
IMPORTANT: Copy and save your API key value, as it CANNOT be recovered and will no longer be available once you navigate away from the page.
Once the API Key is successfully generated, you can utilize it to perform various operations and integrations within the UpStart Commerce Platform. To understand the process of making an API call by using an API Key, please refer to this example request.
To initiate the API Key generation process, you must first have an account on the UpStart Commerce Portal. If you have not registered yet, create an account by visiting this link.
For authorization, you will require two parameters Tenant ID and Session ID.
- Tenant ID: You can create a Tenant ID by visiting this link, or you can request the UpStart Commerce Support Team to create it for you. After successfully creating a Tenant ID, set your specified in the header authorization field.
- Session ID: You can generate a Session ID by simply copying the Curl below and executing it in a terminal or command prompt.
Request:
For more information, go to the Obtain Session ID endpoint example request.
Response:
Note: For authorization, you will need two parameters - Tenant ID and Session ID. Ensure to securely store these values for further API interactions.
Copy the Curl command below to generate an API Key. Replace and with the specific values obtained in step 2.
Request:
For more information, go to the Create New API Key endpoint example request.
Upon making an API Key creation request, it responds with a status code indicating the outcome.
After executing the Curl above, you have successfully generated an API Key. The response includes and for specific API identification, and to check the expiration date of the API Key. Once generated, you can invoke this API Key to start exploring and testing our Management APIs.
Response:
IMPORTANT: To further interact with our APIs, utilize the apiKey and apiKeyId provided in the response.
By following these steps, you can generate an API Key through our APIs , ensuring secure and authorized access to UpStart Commerce Management APIs.
Once the API Key is generated, you can use it in the header of the API request within the Authorization field. This step is crucial for authenticating and accessing Management APIs.
Example API Request:
To use an API Key, replace your-apiKey in the Authorization header with the actual value of the API Key obtained from the response in step 5.
To make your first call by using an API Key, you need to add your API Key and Tenant ID (created above) in the request header by using the Curl below.
Request:
Replace <your-tenantid>with the Tenant ID of your instance and <your-apiKey> with the corresponding value of your API Key. To execute this API you should have a "Portals Users Management" role.
For more information, go to the Get Users by Tenant ID example request.
Response:
Upon successfully receiving the response for the Get Users by Tenant ID request, you have completed your first UpStart Commerce Management API call, using an API Key.