APEX Rest API - Swagger

Question

Я немного новичок во всех плагинах услуг APEX, но мне было интересно, имеет ли Salesforce встроенную поддержку Swagger или любого подобного языка описания REST для REST api, который я создаю на сервисной платформе APEX ?

Например:

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

Я хотел бы возможность вернуть развязность JSON, документ WADL, или что-то для этого REST службы (и всех других REST услуг, у меня есть там). Кто-нибудь знает, как я могу это сделать?

Заранее благодарен!

Answer 1

В настоящее время нет встроенной поддержки. Мне было интересно посмотреть, что можно сделать с помощью доступных общедоступных API-интерфейсов. Первое, на что я столкнулся, - это, по-видимому, не грамматика, как параметры для методов HttpGet. То, что прямо там будет сложно, поскольку единственный способ получить входные параметры - через объект Request, что означает, что вам придется анализировать фактический код. Другими словами, не существует декларативного ввода привязки.

Далее, глядя на инструмент api, который позволяет мне получить некоторую «отражательную» информацию о классе, не всегда имеется достаточная информация для рендеринга полезной нагрузки ответа (в вашем случае она просто отображает LIST, но не то, что в списке)

Опять же, похоже, что нужно было бы полагаться на синтаксический анализатор (существует, по крайней мере, одна грамматика Antl, плавающая вокруг).

(это вызывает некоторое внутреннее внимание, но я не могу сказать больше в это время)