dev:app_store_example_with_postman
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
dev:app_store_example_with_postman [2016/08/11 14:00] – created su | dev:app_store_example_with_postman [2020/12/03 09:32] (current) – su | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== App Store Example using Postman ====== | ||
- | ==== About Postman | + | In this example, we'll use Postman |
- | Postman is an Web API testing tool that runs on top of Google Chrome. It can be downloaded for free and provides a practical example of an external app interacting with the Industrial App Store. | + | //Postman is an Web %%API%% testing tool that runs on top of Google Chrome. It can be downloaded for free and provides a practical example of an external app interacting with the Industrial App Store. |
+ | // | ||
- | Get Postman: [[https:// | + | Download and install |
- | === The Example === | ||
- | In our example we'll request the App Store API method: | + | === App Store Authentication and API Call Example === |
- | This returns info about the logged-in user. | + | In our example we'll prepare a request to the App Store %%API%% method: |
- | {{: | + | //This returns info about the logged-in user.// |
+ | |||
+ | {{ : | ||
If you attempt to execute this directly, you will receive an unauthorized error like the following: | If you attempt to execute this directly, you will receive an unauthorized error like the following: | ||
- | <Code> | + | <code> |
{ | { | ||
" | " | ||
} | } | ||
- | </Code> | + | </code> |
- | This is because the App Store API is secured using OAuth2. | + | This is because the App Store %%API%% is secured using OAuth2. |
- | To prepare an authorization request, select | + | To prepare an authorization request, select: **Authorization |
- | {{:dev:postman02.png?200|}} | + | Specify "add authorization data to request headers" |
+ | |||
+ | {{ :dev:postman01b.png?direct& | ||
+ | |||
+ | Then click **Get New Access Token**. | ||
You will be prompted for the following Authorization parameters: | You will be prompted for the following Authorization parameters: | ||
- | Auth URL https:// | + | {{ :dev:postman02.png? |
- | Access Token URL https:// | + | |
- | Client ID [We'll give you this if you ask] | + | |
- | Client Secret [We'll give you this if you ask] | + | |
- | Scope UserInfo | + | |
- | Grant Type Authorization Code | + | |
- | This returns the Access Token. | + | ^ Grant Type | Authorization Code | |
+ | ^ Call Back %%URL%% | %%https:// | ||
+ | ^ Auth %%URL%% | %%https:// | ||
+ | ^ Access Token %%URL%% | %%https:// | ||
+ | ^ Client %%ID%% | [We'll give you this if you ask] | | ||
+ | ^ Client Secret | [We'll give you this if you ask] | | ||
+ | ^ Scope | %%UserInfo%% | | ||
+ | ^ Client Authentication| Send as Basic Auth header | | ||
- | {{: | ||
- | Select "Use Token", | + | This returns an Access Token. |
+ | |||
+ | {{ : | ||
+ | |||
+ | Select "Use Token", | ||
+ | |||
+ | {{ : | ||
- | {{: | ||
=== Summary === | === Summary === | ||
+ | |||
+ | In the above example we used Postman to simulate an external app interacting with the App Store. Postman has been registered for use with the App Store and obtained the required security credentials. | ||
+ | For more info, see **[[Dev: | ||
+ | |||
+ | Postman exposes the parameters required to make an OAuth2 authorization request. Your application should execute this behind the scenes. For more info, see **[[Dev:App Store API Security Overview]]**. | ||
+ | |||
+ | Finally, we used App Store as a means of authenticating users and presenting user-information. However, there is an extensive %%API%% available, including methods for user-account debiting and real-time process-data interrogation. For more info, see **[[https:// | ||
dev/app_store_example_with_postman.txt · Last modified: 2020/12/03 09:32 by su