soap-to-rest-converter

SOAP to REST Converter Skill

Converts SOAP web services to REST APIs, handling WSDL parsing, operation mapping, and RESTful resource modeling.

Purpose

Enable SOAP modernization for:

• WSDL parsing
• Operation-to-endpoint mapping
• Type conversion
• Authentication migration
• REST resource modeling

Capabilities

1. WSDL Parsing

• Parse WSDL documents
• Extract operations
• Map data types
• Identify bindings

2. Operation-to-Endpoint Mapping

• Map operations to HTTP methods
• Design resource URIs
• Handle parameters
• Transform responses

3. Type Conversion

• Convert XML types to JSON
• Map complex types
• Handle enumerations
• Transform arrays

4. Authentication Migration

• Convert WS-Security
• Implement OAuth2
• Migrate certificates
• Handle API keys

5. SOAP Envelope Removal

• Strip envelope structure
• Extract body content
• Transform headers
• Handle faults

6. REST Resource Modeling

• Design resource hierarchy
• Implement HATEOAS
• Define link relations
• Model collections

Tool Integrations

| Tool | Purpose | Integration Method | |------|---------|-------------------| | SOAP UI | WSDL analysis | GUI | | wsdl2rest | Conversion | CLI | | Custom transformers | Type mapping | Library |

Output Schema

{
  "conversionId": "string",
  "timestamp": "ISO8601",
  "source": {
    "wsdl": "string",
    "operations": "number"
  },
  "target": {
    "openapi": "string",
    "endpoints": "number"
  },
  "mappings": [
    {
      "soapOperation": "string",
      "restEndpoint": "string",
      "method": "string",
      "notes": "string"
    }
  ],
  "typeConversions": [],
  "manualReview": []
}

Integration with Migration Processes

• api-modernization: SOAP to REST conversion

Related Skills

• openapi-generator: REST spec generation
• api-inventory-scanner: Endpoint discovery

Related Agents

• api-modernization-architect: API design