OpenParable
Skip to content
← Back to skills

Soap To REST Converter

Development
soap-to-rest-converter

Soap To REST Converter is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/code-migration-modernization/skills/soap-to-rest-converter/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/soap-to-rest-converter, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

ToolPurposeIntegration Method
SOAP UIWSDL analysisGUI
wsdl2restConversionCLI
Custom transformersType mappingLibrary

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