TIH Developer Portal enables you to create compelling solutions to deliver an enhanced experience for your visitors. This TIH Developer Portal guide will help you get started with:
- Registering for a business or developer account
- Obtaining an API Key
- Obtaining an OAuth Key (To perform specific operations)
1. REGISTERING FOR A BUSINESS OR DEVELOPER ACCOUNT
To gain access to TIH APIs, you can either register for a TIH Business account or a TIH Developer account. Should you be a technology/ software company or a developer representing a business, you are recommended to register for a TIH Business account.
2. OBTAINING AN API KEY
The TIH APIs are built on a RESTful HTTP architecture where the client (your application) makes HTTP requests to access content and services from TIH. The API requests are authenticated with an API Key, which is verified by the TIH API server before allowing any operations. Currently, the API request and response only supports the JSON format.
To retrieve your API Key, sign in to your account and navigate to “My Settings”. Check on “I would like to have an API Key” and click "save".
The API Key grants access to most of the TIH APIs such as:
- Content User API
- Media User API
- Deals User API
- 3rd Party Information Sources API
- Enhanced Navigation Services API
With these APIs, your application can retrieve rich content and images of points-of-interest in Singapore across the 12 content categories (accommodation, attractions, bars and clubs, cruises, deals, events, food and beverages, precincts, malls and shops, tours, venues, and walking trails).
Visit the API pages above for more information about each API, such as the description of the different APIs, tips on the best way to use the API, and a "Try it out" section to experiment with the different APIs. With your API Key, you and your company can get started on using these APIs in your application.
For information on how to use the API Key in your application to call TIH APIs, check out this API User Guide - Using TIH APIs page.
3. OBTAINING AN OAUTH KEY (TO PERFORM SPECIFIC OPERATIONS)
An OAuth Key, which acts as a secret key associated to your API Key, is needed for your company to access the following additional features and to perform specific operations:
- Contribute information via the Content Provider APIs and Media Provider APIs
- Access the Visit Singapore Account APIs, which enable a seamless log in for your customers
- Access the Recommendation Engine APIs which let you provide recommendation services to your customers
- Access the Itinerary Planner APIs which empower your visitors to create their own Singapore itinerary. The Visit Singapore Account service is required for the Itinerary Planner service as a convenient and secure way for your customers to log into your application.
Companies who are interested to use the above additional features and specific operations in your applications, are required to submit this online application form and provide the following information. All applications will be reviewed and may take up to 7 working days for processing.
- Organisation name and Nature of business
- Email address used to register for a TIH Business account
- Intended use of the specific operations APIs
Once the request has been approved, a ClientId (also known as API Key) and ClientSecret (also known as OAuth Key) will be emailed to your company's registered email address provided in the form. The OAuth Key will be tied to your company and registered email address.
For information on how to use the OAuth Key to request for an OAuth authentication token to perform specific operations, check out this API User Guide - Using TIH APIs page.
We hope that the above will help you and your company get started on utilising our APIs to support your business initiatives and needs.