diff --git a/en/docs/assets/img/get_started/api-create.png b/en/docs/assets/img/get_started/api-create.png index b4e9653c4d..8f0a62ebf1 100644 Binary files a/en/docs/assets/img/get_started/api-create.png and b/en/docs/assets/img/get_started/api-create.png differ diff --git a/en/docs/assets/img/get_started/dev-portal-landing-page.png b/en/docs/assets/img/get_started/dev-portal-landing-page.png index 340b5786dd..bfe9e23bf0 100644 Binary files a/en/docs/assets/img/get_started/dev-portal-landing-page.png and b/en/docs/assets/img/get_started/dev-portal-landing-page.png differ diff --git a/en/docs/assets/img/get_started/expanded-get-resource.png b/en/docs/assets/img/get_started/expanded-get-resource.png index c864530a20..fc9757a079 100644 Binary files a/en/docs/assets/img/get_started/expanded-get-resource.png and b/en/docs/assets/img/get_started/expanded-get-resource.png differ diff --git a/en/docs/assets/img/get_started/test-api.png b/en/docs/assets/img/get_started/test-api.png index 34260f03d0..76aa9f4273 100644 Binary files a/en/docs/assets/img/get_started/test-api.png and b/en/docs/assets/img/get_started/test-api.png differ diff --git a/en/docs/assets/img/get_started/try-api.png b/en/docs/assets/img/get_started/try-api.png index 5bc2a98893..da73cdc23c 100644 Binary files a/en/docs/assets/img/get_started/try-api.png and b/en/docs/assets/img/get_started/try-api.png differ diff --git a/en/docs/assets/img/get_started/try-it-success.png b/en/docs/assets/img/get_started/try-it-success.png index 24a25868b1..d1f8ab008c 100644 Binary files a/en/docs/assets/img/get_started/try-it-success.png and b/en/docs/assets/img/get_started/try-it-success.png differ diff --git a/en/docs/assets/img/get_started/try-out.png b/en/docs/assets/img/get_started/try-out.png new file mode 100644 index 0000000000..a61fee4357 Binary files /dev/null and b/en/docs/assets/img/get_started/try-out.png differ diff --git a/en/docs/get-started/api-manager-quick-start-guide.md b/en/docs/get-started/api-manager-quick-start-guide.md index 7143d92d01..55e1a9282a 100644 --- a/en/docs/get-started/api-manager-quick-start-guide.md +++ b/en/docs/get-started/api-manager-quick-start-guide.md @@ -45,35 +45,23 @@ In this sample scenario, you implement a full lifecycle of an API using WSO2 API Let's get started... -### Step 1 - Create and publish an API +### Step 1: Create, Deploy and Publish an API -Follow the instructions below to create and publish an API via the Publisher Portal of WSO2 API-M. +Follow the instructions below to create, deploy and publish an API via the Publisher Portal of WSO2 API-M. 1. Navigate to the Publisher Portal. - `https://localhost:9443/publisher` + [https://localhost:9443/publisher](https://localhost:9443/publisher) 2. Sign in with **`admin/admin`** as the credentials. [![Publisher portal home page]({{base_path}}/assets/img/get_started/api-publisher-home.png)]({{base_path}}/assets/img/get_started/api-publisher-home.png) -3. Create a mock REST service. - - Let's use a mock REST service to create a REST API from scratch. - - A mock service with a JSON response `{"hello": "world"}` is provided by default when you use the service URL as `http://run.mocky.io/v2/5185415ba171ea3a00704eed`, which appears in the [https://designer.mocky.io/](https://designer.mocky.io/) mock service. Let's use the HTTP protocol instead of the HTTPS protocol for this guide. - - !!! tip - Optionally, to test this service, copy the service URL [http://run.mocky.io/v2/5185415ba171ea3a00704eed](http://run.mocky.io/v2/5185415ba171ea3a00704eed) and navigate to it on a new browser. You should see the following JSON message. - - `{"hello": "world"}` - -4. Select **REST API** from the home screen and then click **Start From Scratch**. +3. Next, let's create a **REST API** in the API Manager to proxy an existing REST service by selecting **REST API** from the home screen and then click **Start From Scratch**. [![Design a new REST API]({{base_path}}/assets/img/get_started/design-new-rest-api.png)]({{base_path}}/assets/img/get_started/design-new-rest-api.png) - -5. Enter the API details. +4. Fill the following API details in the relevant fields. @@ -81,13 +69,13 @@ Follow the instructions below to create and publish an API via the Publisher Por Name - @@ -99,20 +87,16 @@ Follow the instructions below to create and publish an API via the Publisher Por -
- HelloWorld + RandomUUID
Context /hello + /uuid
Endpoint http://run.mocky.io/v2/5185415ba171ea3a00704eed -
-

Note

-

Use the HTTP protocol because to use HTTPS you need to import the [https://designer.mocky.io/](https://designer.mocky.io/) certificate into WSO2 API-M.

-
+ 		https://dev-tools.wso2.com/gs/helpers/v1.0/uuid
- [![Create an API]({{base_path}}/assets/img/get_started/api-create.png){: style="width:60%"}]({{base_path}}/assets/img/get_started/api-create.png) - -6. Click **Create & Publish**. +5. Click **Create & Publish**. + + [![Create an API]({{base_path}}/assets/img/get_started/api-create.png){: style="width:100%"}]({{base_path}}/assets/img/get_started/api-create.png) - This will publish your first API on the Developer Portal as well as deploy it on the API Gateway. You now have an OAuth 2.0 secured REST API that is ready to be consumed. + This will publish your first API on the Developer Portal as well as deploy it on the gateway. You now have an OAuth 2.0 secured REST API that is ready to be consumed. @@ -124,7 +108,7 @@ Follow the instructions below to subscribe to the API and generate the keys via `https://localhost:9443/devportal` - The published `HelloWorld` API is listed in the Developer Portal as shown below. + The published `RandomUUID` API is listed in the Developer Portal as shown below. [![Developer Portal home page]({{base_path}}/assets/img/get_started/dev-portal-landing-page.png)]({{base_path}}/assets/img/get_started/dev-portal-landing-page.png) @@ -132,7 +116,7 @@ Follow the instructions below to subscribe to the API and generate the keys via 3. Click on the API thumbnail to view the overview of the API. - [![API overview]({{base_path}}/assets/img/get_started/api-overview.png)]({{base_path}}/assets/img/get_started/api-overview.png) + [![API overview]({{base_path}}/assets/img/get_started/try-out.png)]({{base_path}}/assets/img/get_started/try-out.png) 4. Register an OAuth 2.0 application. @@ -225,7 +209,7 @@ Follow the instructions below to invoke the previously created API with the gene [![GET resource]({{base_path}}/assets/img/get_started/try-api.png)]({{base_path}}/assets/img/get_started/try-api.png) - You should see the `{"hello" : "world"}` response from the API. + You should see the `{"uuid": ""}` response from the API. [![Successful response]({{base_path}}/assets/img/get_started/try-it-success.png)]({{base_path}}/assets/img/get_started/try-it-success.png)