The wsdl2openapi interceptor exposes SOAP/WSDL services via HTTP/JSON/OpenAPI. It automatically converts JSON requests to SOAP XML and SOAP XML responses back to JSON.
Can only be used within an api, and only one wsdl2openapi is allowed per API: it owns the paths and the generated OpenAPI document of the API it is placed in. To expose several WSDLs, declare one API per WSDL.
The generated OpenAPI document's title is the enclosing api's name.
Example Configuration
api:
name: Purchasing API
port: 2000
path: /purchasing
flow:
- wsdl2openapi:
wsdl: http://backend-service/service.wsdl
description: Look up and create purchase orders.
operations:
getAll:
method: GET
path: articles
createOrder:
method: POST
path: orders
api:
name: Purchasing API
port: 2000
path: /purchasing
flow:
- wsdl2openapi:
wsdl: http://backend-service/service.wsdl
description: Look up and create purchase orders.
operations:
getAll:
method: GET
path: articles
createOrder:
method: POST
path: orders
Syntax
wsdl2openapi:
wsdl: <string> # required
description: <string>
operations: {}
wsdl2openapi:
wsdl: <string> # required
description: <string>
operations: {}
Attributes
| Name | Required | Default | Description | Examples |
|---|---|---|---|---|
| description | false | - | API-level description, shown above the auto-generated note about how this OpenAPI document was produced. | Look up partner records by ID. |
| wsdl | true | - | The WSDL (URL or file). | http://backend-service/service.wsdl |
Child Structure
| Element | Cardinality | Description |
|---|---|---|
| operations | 0..1 | Named map of WSDL operations to expose via OpenAPI |