Over a million developers have joined DZone.

Extending the Prototyping Capabilities of WSO2 API Manager

DZone's Guide to

Extending the Prototyping Capabilities of WSO2 API Manager

Check out how to create API prototypes with mediation policies, and showing the power of WSO2 API manager.

· Integration Zone ·
Free Resource

SnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.

What's covered: creating API prototypes using mediation policies for APIM 1.10.0
WSO2 API Manager comes with API prototyping capability OOTB. However if you are in need of advanced prototyping capabilities or feel restricted by the available implementation for the time being you could tap into the underlying mediation engine (WSO2 ESB) to meet your prototyping need.

1) Create a Mediation Policy With the Prototype Logic

The mediation policy should be such that it responds back to the client with the configured response rather than passing the message back to the backend. We can achieve this requirement using Respond [1] and Payload Factory mediators [2].

 <sequence xmlns="http://ws.apache.org/ns/synapse" name="prototypesequence">
   <header name="To" action="remove"></header>
   <header name="CustomHeader" scope="transport" value="test123"></header>
   <property name="RESPONSE" value="true"></property>
   <property name="NO_ENTITY_BODY" action="remove" scope="axis2"></property>
   <payloadFactory media-type="json">
      <format>               {"id":"101","name": "dumiduh","desc": "hard coded json"}            </format>
   <class name="org.wso2.carbon.apimgt.usage.publisher.APIMgtResponseHandler"/>

The example above is using a hardcoded response body and headers, you could also populate the response with variables as required [3]. Find the example mediation policy here [4].

2) Attach Mediation Policy to API in Flow

Start creating an API with required HTTP methods etc, select Manage API from implementation and from Message Mediation Policies section upload the prototype mediation policy. Publish the API.

Image title

3) Invoke

Invoke the API as you would any other managed API [5].

[1] - https://docs.wso2.com/display/ESB490/Respond+Mediator
[2] - https://docs.wso2.com/display/ESB490/PayloadFactory+Mediator
[3] -https://docs.wso2.com/display/ESB490/PayloadFactory+Mediator#PayloadFactoryMediator-Example3:Addingarguments
[4] -  https://drive.google.com/file/d/0B9oVIeyHJKBXb0xkTGUwSmlJc0E/view?usp=sharing
[5] - https://docs.wso2.com/display/AM1100/Quick+Start+Guide

With SnapLogic’s integration platform you can save millions of dollars, increase integrator productivity by 5X, and reduce integration time to value by 90%. Sign up for our risk-free 30-day trial!

wso2 apim ,api management ,middleware ,synapse

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}