# Soap To REST Converter

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

- Skill: `a5c-ai/soap-to-rest-converter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add a5c-ai/soap-to-rest-converter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/a5c-ai/soap-to-rest-converter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: a5c-ai (https://skillmd.com/u/a5c-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/a5c-ai/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

```json
{
  "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