Register and log in to the Open Data Hub and Developer Portal
Creating and managing your application
Accessing APIs
Accessing static datasets and resources
Register and log in to the Open Data Hub and Developer Portal
You need to register and log in to create an application and access our APIs.
How to Register
- At the top of the page, above BROWSE DATA, click REGISTER
- Fill in the registration form, including all required fields. Read the Terms and Conditions of Use then scroll down and click Accept Terms & Conditions of Use. Click CREATE NEW ACCOUNT
- A welcome email will be sent to you with your account details and a link to set your password. Click on the link, or copy and paste it into your browser
- Set your password and click LOG IN
- Your account details page will show. Review your account details, and click Save
How to Log In
- On the home page of the Transport for NSW Open Data Hub click LOG IN
- Enter your login details, username and password, and click the ‘LOG IN’ button
Creating and managing your application
Once you have registered and logged in, you can create an application and access API keys.
Create your application
- Once logged in, you will be taken to the Data Catalogue. At the top of the screen, hover over (don't click) MY ACCOUNT and select Applications from the drop down menu
- Click +ADD APPLICATION
- Fill in the required fields of the Create Application form. Click SAVE when complete
- Details of your application will appear
a) To make changes, or to delete the application, click Edit
b) To return to the Applications page, click Back to Applications
- You will now be able to see your application on the Applications page
Manage your application
- At the top of the screen, hover over (don't click) MY ACCOUNT and select Applications from the drop down menu
- Applications you have created will appear in the list. Click Edit next to an application to view or change details or settings
- Make the required changes to your application, then click SAVE
Accessing APIs
Using your application and API key, you can interact with our APIs, see query results and develop your apps. APIs can be accessed through the Data Catalogue or the API Explorer. You must be logged in to interact with the APIs.
Browse the data catalogue
- At the top of the page, click BROWSE DATA. If you have just logged in, the Data Catalogue will open automatically
- In the Data Catalogue, you can:
a) Search for the API you want to use (shown in this example)
b) Browse through all APIs if you aren't sure which API you want to use - Enter the name, or part of the name, of the API you want to use in the search bar and click APPLY
- Click on the API to see details and resources
- Click EXPLORE API next to the resource you want to use to open it in the API Explorer
- Set the Authentication type as API Key, and choose an application
- Under the API key, there is a list of operations for that resource. Click Expand Operations to see the resource’s details and response messages
- Scroll to the bottom of the command you want to trigger, and click Try it out! to get a response from the API. A curl command, the request URL, response body, response code and response headers will display
Use the API explorer
The API Explorer displays information about the API, resource, method, and parameters you select for a query. When you submit a query, the API Explorer displays the query string and the API results. The API Explorer can also display error messages.
1. At the top of the screen, hover over (don’t click) DEVELOPERS and select API Explorer from the drop down menu
2. A list of available datasets and resources will show on the left hand side. Click on a resource to see details and operators
3. Set the Authentication type as API Key, and choose an application
4. Under the API key, there is a list of operations for that resource. Click Expand Operations to see the resource’s details and response messages
5. Scroll to the bottom of the command you want to trigger, and click Try it out! to get a response from the API. A curl command, the request URL, response body, response code and response headers will display
Accessing static datasets and resources
Static datasets and resources are available for download in the Data Catalogue
1. At the top of the page, click BROWSE DATA. If you have just logged in, the Data Catalogue will open automatically
2. In the Data Catalogue, you can:
a) Search for the dataset or resource you want to use (shown in this example)
b) Browse through all datasets and resources if you aren’t sure what you want to use
3. Enter the name, or part of the name, of the dataset or resource you want to use in the search bar and click APPLY
4. Click a dataset or resource to see details
5. If you want to download a resource, click DOWNLOAD next to the resource. If you want to view more details about the resource, click EXPLORE
6. If you want to download the resource after viewing more details, click on the resource or click Download at the top of the screen
What's next? You can download and read the documentation, learn about API Basics and connect with us via the forum.