Traduzido com IA. Ainda não revisto 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-o a entender como usá-las com eficácia em diversas tarefas de integração.

Entender a autenticação

Antes de entrar nas APIs, é fundamental entender o processo de autenticação. Quando um navegador acede ao Salesforce, autentica-se num servidor antes de chegar ao conteúdo privado. Essa autenticação é essencial, seja para aceder a 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. Uma aplicação cliente e um navegador autenticam-se através do servidor de autenticação e depois 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 os seus recursos e a sua compatibilidade durante anos, até que sejam descontinuadas.

Como consumidor, precisa de saber que versão está a usar e de estar pronto para migrar para versões mais recentes (com testes).

APIs REST e SOAP personalizadas

Para as APIs REST ou SOAP personalizadas que criar, o Salesforce não oferece versionamento. Gerir e manter essas APIs é responsabilidade sua, garantindo que funcionam 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 através de uma aplicação ligada e de um utilizador de integração

Autenticação de clientes externos

Quando clientes externos acedem ao Salesforce, precisam de se autenticar através de fluxos específicos. Esses clientes podem ser de vários tipos, incluindo clientes SOAP que usam o WSDL Enterprise ou Partner, clientes REST, clientes da Bulk API e muitos outros.

Explorar 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 a saúde e a indústria, há uma API para quase todas as necessidades.

Captura de ecrã: 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 programador

Para programadores 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 eliminar dados a partir de fora do Salesforce, o que o torna essencial para testar e desenvolver APIs.

Captura de ecrã: um pedido no Postman a executar uma consulta SOQL na API REST do Salesforce, com o cabeçalho de autorização e a resposta JSON

Usar 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 programador da API REST e as várias coleções do Postman disponíveis no GitHub podem facilitar muito o seu desenvolvimento.

Conclusão:

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

Esteja à vontade para explorar, experimentar e integrar!

Fique atento

Comece a 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). Subscreva e aprofunde o seu entendimento do Salesforce e de como integrá-lo com outros sistemas.

A ajudar a mudar o mundo, partilhando 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