このページはAIで翻訳されています。コミュニティによるレビューはまだ行われていません。 英語で読む

ブログ · 2023年10月10日 · Steve Simpson · 統合

Across the APIs:Salesforce API のまとめ

統合シリーズの新しい回へようこそ。今回は、効果的な統合に欠かせない Salesforce API の複雑な世界を探ります。

Salesforce API の紹介

Salesforce API を進んでいく

Salesforce には数多くの API があり、それぞれが異なる目的を持ち、異なる機能を提供しています。このガイドではそれらの API を順に紹介し、さまざまな統合タスクにどう効果的に使うかを理解できるようにします。

認証を理解する

API に入る前に、認証のプロセスを理解しておくことが大切です。ブラウザが Salesforce にアクセスするとき、非公開のコンテンツに届く前にサーバーに対して認証します。この認証は、公開 Web サイトや Experience ポータル、さらには Web-to-リードや Web-to-ケース用の公開ページにアクセスする場合でも重要です。

図:Salesforce へのアクセスと API。クライアントアプリケーションとブラウザが認証サーバーを通じて認証し、バージョン管理された Web サービス(標準 API)、バージョン管理されないカスタム REST・SOAP サービス、公開サイト、Web-to-リード、メール-to-ケースに到達する

バージョン管理される Web サーバーとされない Web サーバー

バージョン管理の重要性

Salesforce は API を特定のバージョン番号で公開し、最終的に廃止されるまで何年もその機能と互換性を維持します。

利用する側は、自分がどのバージョンを使っているかを知り、新しいバージョンへ(テストをしたうえで)アップグレードする準備をしておく必要があります。

カスタム REST API と SOAP API

自分で作るカスタム REST API や SOAP API には、Salesforce によるバージョン管理はありません。Salesforce のアップデートのたびに期待どおり動くよう、これらの API を管理・保守するのはあなたの責任です。

図:外部クライアントが接続アプリケーションと統合ユーザーを通じて認証した後に呼び出せる Salesforce API(SOAP、REST、Bulk、Apex SOAP と REST、メタデータ、Tooling、ストリーミング、Pub/Sub)

外部クライアントの認証

外部クライアントが Salesforce にアクセスするときは、特定のフローで認証しなければなりません。こうしたクライアントには、Enterprise WSDL や Partner WSDL を使う SOAP クライアント、REST クライアント、Bulk API クライアントなど、さまざまな種類があります。

さまざまな API を探る

Salesforce には、特定のタスクや機能のために設計された幅広い API があります。新しい Salesforce Event Bus から、ヘルスケアや製造業などの業界向けに設計された API まで、ほとんどあらゆるニーズに応える API があります。

スクリーンショット:Salesforce Developers サイトの Browse APIs ページ。API のカードが並んでいる

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

ツールとリソース

Postman:開発者の親友

Salesforce API を扱う開発者にとって、Postman のようなツールは非常に役立ちます。Postman を使えば、Salesforce の外から認証やクエリを実行し、データの挿入・編集・更新・削除まで行えるので、API のテストと開発に欠かせないツールです。

スクリーンショット:Salesforce REST API に SOQL クエリを実行する Postman のリクエスト。Authorization ヘッダーと JSON レスポンスが見える

ドキュメントとコレクションを活用する

利用できるドキュメントに慣れることが、Salesforce API を使いこなす鍵です。REST API 開発者ガイドや、GitHub で公開されているさまざまな Postman コレクションなどのリソースは、開発を大いに楽にしてくれます。

まとめ:

Salesforce API を理解し、効果的に使うことは、Salesforce を扱うすべての統合開発者やアーキテクトにとって欠かせません。幅広い API とツールを使えば、Salesforce のデータと設定の両方を効率よく操作し、読み取り、編集し、更新できます。

自由に探り、試し、統合してみてください!

お楽しみに

自信を持って Salesforce API の旅に出かけましょう! さらなる知見やヒントは、この www.SteveTechArc.com と YouTube チャンネル @SteveTechArc (opens in a new tab) で。チャンネル登録して、Salesforce と、それをほかのシステムとどう統合できるかの理解を深めてください。

アーキテクト仲間やアーキテクトを目指す人たちと統合の知識を共有して、世界を変える手助けを!

文字起こしには AI を活用

STA 1.9