Traduzido por IA. Ainda não revisado pela comunidade. Ler em inglês

Blog · 10 de outubro de 2023 · Steve Simpson · Integração

Across the APIs: resumo das APIs do Salesforce

Bem-vindo a mais um capítulo da série de integração. Desta vez, exploramos o mundo complexo das APIs do Salesforce, um componente crucial para integrações eficazes.

Introdução às APIs do Salesforce

O Salesforce oferece uma infinidade de APIs, cada uma com propósitos distintos e funcionalidades diferentes. Este guia apresenta essas APIs e ajuda você a entender como usá-las com eficácia em diversas tarefas de integração.

Entendendo a autenticação

Antes de entrar nas APIs, é fundamental entender o processo de autenticação. Quando um navegador acessa o Salesforce, ele se autentica num servidor antes de chegar ao conteúdo privado. Essa autenticação é essencial, seja para acessar sites públicos, portais Experience ou até páginas públicas para web-to-lead e web-to-case.

Diagrama: acesso ao Salesforce e APIs. Um aplicativo cliente e um navegador se autenticam pelo servidor de autenticação e então chegam aos serviços web versionados (as APIs padrão), aos serviços REST e SOAP personalizados não versionados, aos sites públicos, ao Web-to-Lead e ao Email-to-Case

Servidores web versionados e não versionados

A importância do versionamento

O Salesforce lança APIs com números de versão específicos e mantém seus recursos e sua compatibilidade por anos, até que sejam descontinuadas.

Como consumidor, você precisa saber qual versão está usando e estar pronto para migrar para versões mais novas (com testes).

APIs REST e SOAP personalizadas

Para as APIs REST ou SOAP personalizadas que você cria, o Salesforce não oferece versionamento. Gerenciar e manter essas APIs é responsabilidade sua, garantindo que funcionem como esperado a cada atualização do Salesforce.

Diagrama: as APIs do Salesforce que um cliente externo pode chamar (SOAP, REST, Bulk, Apex SOAP e REST, Metadata, Tooling, Streaming e Pub/Sub) depois de se autenticar por um aplicativo conectado e um usuário de integração

Autenticação de clientes externos

Quando clientes externos acessam o Salesforce, precisam se autenticar por fluxos específicos. Esses clientes podem ser de vários tipos, incluindo clientes SOAP usando o WSDL Enterprise ou Partner, clientes REST, clientes da Bulk API e muitos outros.

Explorando diferentes APIs

O Salesforce tem uma ampla gama de APIs, cada uma pensada para tarefas e funções específicas. Do novo Salesforce Event Bus a APIs feitas para setores como saúde e manufatura, há uma API para quase toda necessidade.

Captura de tela: a página Browse APIs do site Salesforce Developers, com a lista de cartões de API

https://developer.salesforce.com/docs/apis (opens in a new tab)

Ferramentas e recursos

Postman: o melhor amigo do desenvolvedor

Para desenvolvedores que trabalham com as APIs do Salesforce, ferramentas como o Postman são valiosíssimas. O Postman permite fazer autenticações, consultas e até inserir, editar, atualizar ou excluir dados de fora do Salesforce, o que o torna essencial para testar e desenvolver APIs.

Captura de tela: uma requisição no Postman executando uma consulta SOQL na API REST do Salesforce, com o cabeçalho de autorização e a resposta JSON

Usando documentação e coleções

Conhecer bem a documentação disponível é a chave para dominar as APIs do Salesforce. Recursos como o guia do desenvolvedor da API REST e as várias coleções do Postman disponíveis no GitHub podem facilitar muito seu desenvolvimento.

Conclusão:

Entender e usar bem as APIs do Salesforce é crucial para qualquer desenvolvedor ou arquiteto de integração que trabalhe com o Salesforce. Com uma ampla gama de APIs e ferramentas à disposição, você pode manipular, ler, editar e atualizar dados e configurações no Salesforce com eficiência.

Fique à vontade para explorar, experimentar e integrar!

Fique de olho

Comece sua jornada pelas APIs do Salesforce com confiança! Para mais ideias e dicas, acompanhe aqui em www.SteveTechArc.com e no canal do YouTube @SteveTechArc (opens in a new tab). Inscreva-se e aprofunde seu entendimento do Salesforce e de como integrá-lo a outros sistemas.

Ajudando a mudar o mundo compartilhando conhecimento sobre integração com outros arquitetos e com quem está na jornada para se tornar um!

Transcrição feita com a ajuda de IA

STA 1.9