APEX Rest API - Swagger

Question

我对整个 APEX 服务插件有点陌生，但我想知道 Salesforce 是否对我在 APEX 服务平台中创建的 REST api 的 Swagger 或任何类似的 REST 描述语言具有本机支持？

例如：

@RestResource(urlMapping='/v1/users/*')
global with sharing class UserRestService {
  ...
  @HttpGet
  global static List<Member__c> doGet(....)
  {
     ...
  }
}

我希望能够返回 swagger json、WADL 文档或此 REST 服务（以及我在那里拥有的所有其他 REST 服务）的其他内容。 有谁知道我可以做到这一点的方法吗？

提前致谢！

Answer 1

目前没有内置支持。我有兴趣了解通过当前可用的公共 API 可以做什么。我遇到的第一件事是语法似乎不喜欢 HttpGet 方法的参数。这将使它变得具有挑战性，因为获取输入参数的唯一方法似乎是通过请求实体，这意味着您必须解析实际的代码。换句话说，似乎没有声明性输入绑定。

此外，在查看工具 API（它让我获得一些有关该类的“反射”信息）时，并不总是有足够的信息来呈现响应负载（在您的情况下，它只显示 LIST，但不显示列表中的内容） )

再次，看起来必须依赖解析器（至少有一种 Antl 语法）。

（这引起了一些内部关注，但我现在不能再说了）

Answer 2

有一个名为

SF Explorer 的免费工具可以执行此操作。