soap-to-rest-converter

// Convert SOAP web services to REST APIs with WSDL parsing and resource modeling

$ git log --oneline --stat

stars:384

forks:73

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namesoap-to-rest-converter

descriptionConvert SOAP web services to REST APIs with WSDL parsing and resource modeling

allowed-toolsBash,Read,Write,Grep,Glob,Edit

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