能否用WSDL描述REST/HATEOAS API？能否像Hydra那样定义超媒体控件？

1. WSDL能否描述REST/HATEOAS API？ #

WSDL（尤其是2.0版本）确实可以描述符合REST风格的API表层特征，但它本质是为SOAP这类RPC/文档型服务设计的，和REST的核心理念存在天然冲突：

• WSDL是静态契约驱动的，会预先定义所有端点、请求响应结构和交互模式；而REST（尤其是HATEOAS）强调动态交互发现，客户端通过响应中的超媒体控件知晓下一步操作，无需提前掌握完整API契约。
• 你提到的WSDL 2.0 Primer里的REST示例，只是用WSDL语法套了HTTP方法、资源路径这类REST的外在特征，完全没有覆盖HATEOAS的核心——超媒体交互逻辑。

2. 能否用WSDL像Hydra那样描述超媒体控件？ #

从技术实现角度，WSDL 2.0的扩展机制（比如自定义元素、类型扩展）理论上可以硬塞进超媒体相关描述，但这绝非合理方案：

• 语义完全不匹配：WSDL的模型里没有“超媒体控件”“链接关系”这类原生概念，强行扩展会让契约变得晦涩难懂，且主流API工具（如代码生成器）无法原生支持这些自定义逻辑。
• 违背HATEOAS本质：HATEOAS的核心是让客户端在运行时动态发现操作，而WSDL是提前固化所有交互规则，就算用WSDL描述了超媒体，也把动态交互变成了静态契约，彻底偏离HATEOAS的设计初衷。
• 专用规范更合适：Hydra这类规范是专为REST超媒体API打造的，原生支持链接关系、操作描述、语义约束等HATEOAS必备特性，比强行改造WSDL高效且合理得多。

总结：WSDL能勉强适配REST的表层特征，但完全不适合描述HATEOAS风格的超媒体API，也无法替代Hydra这类专用规范。

内容的提问来源于stack exchange，提问作者Pierre Thierry