This documentation is for WSO2 App Factory 1.0.0. View documentation for the latest release.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

The sample is described in the following topics.

Table of Contents


This sample demonstrates how to invoke yahoo weather API and displays results in a Web application.


  1. Register and log in to WSO2 App Factory here: . See instructions in Getting Started.
  2. Log in to API Publisher ( and add API by the name yahoo weather 1.0.0. Provide the following values in Add New API window.

    For more information on creating an API, see APIs.

You now have a sample API created in App Factory. Let's see how to consume this from your Web app.

Executing the sample

  1. Log in to App Factory portal and click Add New Application to create a new application with the following specifications:

    Name: API-Invoker
    Application Type: Web Application
    Repository Type: Git

    For more information on creating applications, see Creating and Viewing Applications.
  2. Check out the  API-Invoker source code using the Git clone command. It's folder structure is as follows:
  3.  Write your application to get keys by calling the CarbonContext and Registry APIs. The correct sandbox and production keys (consumer key and consumer secret) are used depending on where the application is deployed

  4. You can find the source code of this sample in <AF_HOME>/samples directory and the sample index.jsp with above changes in API_Invoker/API_Invoker/WebContent/index.jsp. Replace this file in API-Invoker. 
  5. Commit the changes to Git repository. 
  6. Subscribe the application to the Yahoo Weather API using steps below:

    • In App Factory portal, select the API-Invoker application.
    • Select the Resources tab from the left panel and scroll down to select APIs section. Then, click Subscribe to APIs.
      The API Manager's storefront opens in a separate window:
    • Click the yahoo weather - 1.0.0 API you created earlier. For example,

    • Select  API-Invoker from 'Applications' drop down and click 'Subscribe' button. You will get the 'Subscription Successful' pop-up.