Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified en/docs/assets/img/get_started/api-create.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/docs/assets/img/get_started/dev-portal-landing-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/docs/assets/img/get_started/expanded-get-resource.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/docs/assets/img/get_started/test-api.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/docs/assets/img/get_started/try-api.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified en/docs/assets/img/get_started/try-it-success.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added en/docs/assets/img/get_started/try-out.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
46 changes: 15 additions & 31 deletions en/docs/get-started/api-manager-quick-start-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,49 +45,37 @@ 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.

<table>
<tr>
<th>
Name
</th>
<td>
HelloWorld
RandomUUID
</td>
</tr>
<tr>
<th>Context
</th>
<td><code>/hello</code>
<td><code>/uuid</code>
</td>
</tr>
<tr>
Expand All @@ -99,20 +87,16 @@ Follow the instructions below to create and publish an API via the Publisher Por
<tr>
<th>Endpoint
</th>
<td><code>http://run.mocky.io/v2/5185415ba171ea3a00704eed</code>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><b>Use the HTTP protocol</b> because to use HTTPS you need to import the [https://designer.mocky.io/](https://designer.mocky.io/) certificate into WSO2 API-M.</p>
</div>
<td><code>https://dev-tools.wso2.com/gs/helpers/v1.0/uuid</code>
</td>
</tr>
</table>

[![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.

<a name="subscribe"></a>

Expand All @@ -124,15 +108,15 @@ 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)

2. Click **Sign-In** and enter **`admin/admin`** as your credentials to sign in to the Developer Portal.

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.

Expand Down Expand Up @@ -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": "<random-uuid-here>"}` 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)

Expand Down