VMware GemFire Developer REST APIs are integrated with the Swagger™ framework. This framework provides a browser-based test client that allows you to visualize and try out VMware GemFire REST APIs.

Swagger application JARs are included in the VMware GemFire REST application WAR; you do not need to install any additional libraries to use Swagger.

The following example demonstrates how to access the Swagger UI to browse the APIs.

  1. Start a VMware GemFire Locator and a Developer REST API-enabled server as described in Setup and Configuration. Specify an http-service-port for the developer REST service, as the default port, 7070, is already taken by the locator. For example:

    gfsh>start locator --name=locator1
    Starting a VMware GemFire Locator in /Users/admin/apache-geode-1.2.0/locator1...
    gfsh>start server --name=server1  --start-rest-api=true \
    --http-service-bind-address=localhost --J=-Dgemfire.http-service-port=8080
  2. To access Swagger, open a browser and enter the following URL. For example:


    The following Web page appears: Swagger home page

  3. Using gfsh, create one or more regions on the REST API server. For example:

    gfsh>create region --name=region1 --type=REPLICATE --key-constraint=java.lang.String
    Member  | Status
    ------- | ------------------------------------------
    server1 | Region "/region1" created on "server1"
  4. In Swagger, click on region : region CRUD operations to list all the available endpoints for accessing regions. List of available endpoints for accessing regions within Swagger

  5. In the list of region endpoints, click on the GET /v1 endpoint link. The page displays additional request and response information about the API. Request and response information about the API in Swagger
  6. Click the Try it out! button. Any regions you added in step 5 are returned in the response body. API response page in Swagger
  7. Add an entry to the region by expanding the POST /v1/{region} endpoint. Expanded Post /v1/ endpoint interface in Swagger
  8. Click the Try it out! button to see the response body and response code. updated API response page in Swagger

You can use the Swagger interface to try out additional VMware GemFire API endpoints and view sample responses.

For more information on Swagger, see the Swagger website and the OpenAPI specification.

check-circle-line exclamation-circle-line close-line
Scroll to top icon