兼具SOAP服务特性与REST表象的混合API如何称谓？

一、你的核心判断完全在线！ #

你总结的两大API风格的核心差异非常精准，我再补充点细节帮你巩固：

• 关于REST：你提到的JSON格式、简洁一致的接口、围绕实体（entities）的CRUD访问、无强制正式契约都是REST的标志性特征。REST本质是「资源导向」——每个端点对应一个具体资源（或资源集合），通过HTTP标准方法（GET/POST/PUT/DELETE）来表达对资源的操作意图，契约通常靠文档（比如OpenAPI）而非强制绑定，灵活性拉满但也需要开发者自觉遵循约定。
• 关于SOAP：XML格式、复杂接口、围绕服务（services）的操作访问、基于WSDL的强制预定义契约也完全命中了SOAP的核心。SOAP是「操作导向」，关注的是执行特定业务动作，WSDL会严格定义请求/响应的结构、数据类型甚至传输协议，规范性极强但相对笨重。

二、这类混合API的标准称谓 #

你描述的这种“披着REST外衣的操作型API”，业内有几个通用的正式称呼，完全不用只叫它“糟糕的API”：

1. RPC-over-HTTP（或JSON-RPC）：这是最主流的叫法。它本质是远程过程调用（RPC），只不过用HTTP当传输载体、JSON当数据格式，和SOAP一样是「操作导向」，但砍掉了SOAP的XML信封和WSDL强契约约束。你举的/sendUserAnUpdate/1111、/makeCommentTextPurple/3333例子，完全就是RPC的典型形态——直接调用一个命名好的业务操作，而非对某个资源做CRUD。
2. Action-oriented API：这个叫法更直白，直接点明它是围绕「动作/操作」而非「资源」设计的，和REST的资源导向形成明确区分。

至于你提到的两个备选名称：

• 「JSON SOAP API」不太准确，因为SOAP本身有严格的XML规范，用JSON就脱离了SOAP的定义范畴；
• 「Service-based REST API」有点自相矛盾，因为REST的核心是资源而非服务，这么叫容易混淆概念，不推荐使用。

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