将 Salesforce 数据公开为 Rest API

Question

我是 Salesforce 的新手，我想就如何将 Sales force 数据公开为 Rest API 以便外部系统可以使用它获得一些专家建议。 我想如果我可以创建一个像下面这样的 Apex 类

@RestResource(urlMapping='/GetAccounts/*')
global with sharing class GetAccounts {
    @HttpGet
    global static Account doGet() {
        RestRequest req = RestContext.request;
        RestResponse res = RestContext.response;
        String accountId = req.requestURI.substring(req.requestURI.lastIndexOf('/')+1);
        Account result = [SELECT Id, Name FROM Account WHERE Id = :accountId];
        return result;
    }
}

对于使用数据的外部用户，我想我可以设置一个连接的应用程序并为他们提供用户名、密码、消费者密钥、消费者秘密，他们应该在 Salesforce 中进行身份验证以获取 URI 和会话 ID。 使用 SessionID 和 URI 应该能够调用上面公开的 API。 这是正确的方法吗，如果我在这里遗漏了什么，请告诉我。

还需要将 Swagger 与 API 一起使用，是否可以在 Apex 类中使用 Swagger。 你能帮助我如何在我的 API 中利用 Swagger。

Answer 1

首先，您应该尝试使用 Salesforce 标准 REST API。 您可以从此处查看完整文档。 https://developer.salesforce.com/docs/api-explorer/sobject/Account

您可能会问自己，什么时候我应该像您提供的代码那样将 APEX 类公开为 REST API？ 当您需要执行自定义逻辑并将其与 API 调用结合时，您需要这样做。

尚不支持将 Salesforce REST API 作为 OPEN API 规范（Swagger）公开。 如果您需要，您可以为这个想法投票。 https://success.salesforce.com/ideaView?id=0873A000000cQsxQAE

但支持另一种方式。 您可以导入 swagger 规范文件并使用来自 Salesforce 的点击来调用它。 查看此博客了解更多详情： https : //andyinthecloud.com/2017/07/23/simplified-api-integrations-with-external-services/