顶点RestAPI-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，而不显示LIST中的内容）

同样，看起来我们必须依赖于解析器（至少有一个Antl语法）。