soap-to-rest-converter

name	soap-to-rest-converter
description	Convert SOAP web services to REST APIs with WSDL parsing and resource modeling
allowed-tools	["Bash","Read","Write","Grep","Glob","Edit"]
graph	{"domains":["domain:software-engineering"],"specializations":["specialization:code-migration-modernization"],"skillAreas":["skill-area:api-design","skill-area:breaking-change-management"],"roles":["role:backend-engineer","role:architect"],"workflows":["workflow:technical-debt-reduction"],"topics":["topic:refactoring"]}

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": [
   

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