This tutorial demonstrates the interaction of a client application using Angular 2 with the SKY API authorization service, using the implicit flow (or implicit grant).
- Familiarity with git commands
- The latest, stable version of Git
- A server such as your local machine that is capable of running NodeJS
- A Blackbaud Developer Subscription Key
- If you have not already done so, be sure to complete the Getting started guide. This will guide you through the process of registering for a Blackbaud developer account and requesting a subscription to an API product.
- Once approved, your subscription will contain a Primary Key and a Secondary Key. You can use either key as the subscription key value for the
bb-api-subscription-key
request header when making calls to the API. - You can view your subscription keys on your Blackbaud Developer Profile.
- A Blackbaud Developer Application ID
- Register your application in order to obtain the Application ID (client ID) and Application Secret (client secret).
- A Blackbaud Developer Application Redirect URI
- Specify one or more URIs that should be used when redirecting the user's browser back to your application after providing consent during the authorization process. The URIs must be absolute and use https (note that we do support
http://localhost:port
orhttp://127.0.0.1:port
for local development).
For this tutorial, usehttp://localhost:8080/access_token/
.
- Specify one or more URIs that should be used when redirecting the user's browser back to your application after providing consent during the authorization process. The URIs must be absolute and use https (note that we do support
Open Terminal/Command Prompt and type:
$ git clone https://github.com/blackbaud/sky-api-tutorial-implicit-flow-angular2.git
Duplicate config.json-sample (located in the src/data/
folder) as config.json and fill in the missing values (all required).
`SkyApiSubscriptionKey` | Your [SKY API (Blackbaud) developer subscription key](https://developer.sky.blackbaud.com/developer) (primary or secondary) |
`SkyApiAppId` | Your SKY API registered application's [Application ID](https://developerapp.sky.blackbaud.com/applications) |
Type the following in Command Prompt/Terminal:
npm install
npm start
Visit http://localhost:8080/.