Accessing the APIs
To start accessing Bunnings APIs: register, log in, and create an app to get some API keys.
Apps
Apps contain API keys which allow you to access Bunnings APIs. You can create as many apps as you need, and also many API keys within those apps, where each of those API keys can access one or more APIs.
We recommend having one set of API keys per app as we find that is an easier way to manage what apps, API keys and the API products they have access to.
Apps also have analytics data, which you can view to see traffic, latency, errors and other information concerning the API traffic for each app.
Viewing your apps
Click on Apps for personal apps(deprecated), or Teams and select your team and then the application that the team owns
NOTE: There are 3 Bunnings developer environments; sandbox, test and live. You will find your apps to those environments in each of the associated developers portals. See Environments for more details.
Create an app
Click on Teams and select the team you want to create an app under
Click on Team Apps and then click the Add team app button
Enter:
- Team Application Name
- Provide a Description (optional)
- Select the API products the app will have access to
Click Add team app
Your new app will now be available in your Apps list.
NOTE: For test and live environments, the API products you add to an app will be Pending Approval, and will be manually reviewed by Bunnings. A review normally takes no more than 3 working days. See Getting Started for more details on accessing test APIs and accessing live APIs.
NOTE2: Partner APIs are only selectable for apps with an app owner as a team. That team must also be partner-enabled to view and use partner APIs. Individual developers cannot create apps that access partner enabled APIs. See Teams for more details.
Delete an app
Click on Teams and select the team that owns the app you want to delete
Find the app you wish to delete, click View
From the menu on that app, click Delete
Type the app name in the text box and click Delete.
WARNING! This action cannot be undone. Once deleted any applications using API keys in that app will immediately be unable to use those keys to communicate with any Bunnings API. Creating new keys in test or live will require re-approval of your keys for any selected products.
App Analytics
Click on Apps
Find the app you wish to view analytics, click View
Click on Analytics
You can then select the analytics chart you wish to see for that app;
-
Traffic
-
Latency
- Errors
App API keys (or Credentials)
See API keys in our Security documentation.
Environments
We have 3 environments to help you develop your applications and safely interface with our APIs.
You can use the 3 environments as part of your SDLC in progressing your application from sandbox, to test to our live APIs.
| Sandbox | Test | Live | |
|---|---|---|---|
| Developer Portal: | |||
| Base URL: |
|
|
|
| API Access: | automatic key approval | manual key approval | manual key approval |
| Description: | Mocked responses that mimic the live API | Responses from test environment data and backends | Production responses with live data. |
| Register your account | YES | NO (register on sandbox) | NO (register on sandbox) |
Accessing the environments
First you’ll need to register on the sandbox environment, then you will be able to login to the other 2 portals (test and live) using your same credentials.
You will need to have successfully tested your application using sandbox APIs, before requesting access to test or live APIs.
See the Getting Started page for instructions on how to move from sandbox to test and then to live APIs.