Skip to content

Latest commit

 

History

History
51 lines (26 loc) · 2.77 KB

getting-started.md

File metadata and controls

51 lines (26 loc) · 2.77 KB

Hamburg > Howto > Cognitive APIs on IBM G-Cloud > Getting started

Getting started with Cognitive APIs on IBM G-Cloud

Logo

Your application must have authorization credentials to be able to use the Cognitive APIs. Those credentials need to be send in the HTTP header of each request to the API to identify the application and provide access.

The following sections guide you to obtain those credentials.

Prerequisites

To be able to login to the Cognitive APIs Developer Portal a valid IBM ID is required. This should be the same one as you use to login to IBM Bluemix.

If you don't have one, sign up on ibm.com.

Sign up for a new IBM ID

Create an account on the Developer Portal

Goto the Cognitive API's Developer Portal.

On the top right corner select Login to login with your IBM ID.

After your first login with an IBM ID the portal will ask for your Developer Organization's name. This can be your company name, the name of your university or any other name.

Enter Developer Organization

Obtain authorization credentials

In the Developer Portal select Apps from the main menu and then select Register new App on the upcoming page.

Enter a title for your application and submit the form.

Register Application

In the upcoming screen the Developer Portal shows your Client-Key and Client-Secret. Take a note of both keys - The Client Secret which is displayed in the green box in the top will only be shown once to you. You'll need the keys later when requesting the API.

Client Key & Client Secret

Subscribe APIs

After you've created an application you can subscribe it to the Cognitive APIs. To do so, select API Products from the Developer Portal's main menu. Then select gcloud-services 1.0.2 from the list of API products.

Finally subscribe to the IBM Hackathon 2016 - Hamburg plan by clicking the 'Subscribe' button and selecting your application in the upcoming popup dialog.

Subscribe to Plan

Your application is now entitled to use the APIs with a maximum of 5 requests/ minute.

See How to use Cognitive APIs guide to see how the APIs are used.