Apex Rest API - Swagger

Question

Je suis un peu nouveau pour l'ensemble des plugins de services APEX mais je me demandais si Salesforce prend en charge nativement Swagger, ou tout autre langage de description REST similaire, pour les API REST que je crée sur la plate-forme de service APEX ?

Par exemple:

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

Je voudrais la possibilité de retourner le JSON Swagger, un document WADL, ou quelque chose pour ce service REST (et tous les autres services REST que j'ai là-bas). Est-ce que quelqu'un sait d'une manière que je peux faire ceci?

Merci d'avance!

Answer 1

Il n'y a pas de support intégré pour le moment. Je voulais savoir ce qui pouvait être fait via les API publiques actuellement disponibles. La première chose que j'ai rencontrée est que la grammaire ne semble pas aimer les paramètres des méthodes HttpGet. Ce droit là rendra difficile puisque la seule façon d'obtenir les paramètres d'entrée semble être via l'entité Request, ce qui signifie que vous devrez analyser le code réel. En d'autres termes, il ne semble pas y avoir de liaison d'entrée déclarative. De plus, en regardant l'API qui me permet d'obtenir une quantité d'informations "réfléchissantes" sur la classe, il n'y a pas toujours suffisamment d'informations pour rendre une réponse utile (dans votre cas, cela montre LIST mais pas ce qui est dans la liste)

Encore une fois, il semblerait que l'on devrait s'appuyer sur un analyseur (il y a au moins une grammaire Antl flottant).

(cela devient un peu d'attention interne, mais je ne peux pas en dire plus à ce moment)