name: soap-to-rest-converter description: 将SOAP Web服务转换为REST API,支持WSDL解析和资源建模 allowed-tools: [“Bash”, “Read”, “Write”, “Grep”, “Glob”, “Edit”]
SOAP转REST转换器技能
将SOAP Web服务转换为REST API,处理WSDL解析、操作映射和RESTful资源建模。
目的
支持SOAP现代化改造,包括:
- WSDL解析
- 操作到端点的映射
- 类型转换
- 认证迁移
- REST资源建模
能力
1. WSDL解析
- 解析WSDL文档
- 提取操作
- 映射数据类型
- 识别绑定
2. 操作到端点映射
- 将操作映射到HTTP方法
- 设计资源URI
- 处理参数
- 转换响应
3. 类型转换
- 将XML类型转换为JSON
- 映射复杂类型
- 处理枚举
- 转换数组
4. 认证迁移
- 转换WS-Security
- 实现OAuth2
- 迁移证书
- 处理API密钥
5. SOAP信封移除
- 剥离信封结构
- 提取正文内容
- 转换头部
- 处理故障
6. REST资源建模
- 设计资源层次结构
- 实现HATEOAS
- 定义链接关系
- 模型集合
工具集成
| 工具 | 目的 | 集成方法 |
|---|---|---|
| SOAP UI | WSDL分析 | GUI |
| wsdl2rest | 转换 | CLI |
| 自定义转换器 | 类型映射 | 库 |
输出模式
{
"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": []
}
与迁移流程集成
- api-modernization: SOAP到REST转换
相关技能
openapi-generator: REST规范生成api-inventory-scanner: 端点发现
相关代理
api-modernization-architect: API设计