HubSpotでの認証方式

HubSpotのAPIには、2種類の認証方式があります。OAuthAPIキーです。ほとんどのエンドポイントは(エンドポイントのドキュメントに明記されていない限り)どちらの方式にも対応していますが、非公開アプリを使用してリクエストを送信する場合は、OAuth(つまり、アプリのアクセストークン)を使用することが推奨されます。APIキーは、短期のプロトタイプ開発や1つのアカウント上で使用する連携に適しています。しかし、複数のお客さまを対象とした連携やアプリマーケットプレイスに掲載する連携は、HubSpotのOAuthプロトコルを使用したアプリとして開発する必要があります。 

例:

以下のこのエンドポイントへのcURLリクエストは、使用可能な認証方式を示しています。

OAuth 2.0。認証ヘッダーの中でアクセストークンを使用しています。
/~curl --header "Authorization: Bearer C4d***sVq" https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false
非公開アプリのアクセストークン。
/~curl --header "Authorization: Bearer ***-***-*********-****-****-****-************" https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false
APIキー。hapikey=クエリーパラメーターを使用してURLに追加しています。
/~curl 'https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false&hapikey=456***cfa'

連携を認証する準備は整いましたか?開発者アカウントの作成から始めてみましょう。その後、アプリの開発、OAuthによる認証、開発者アカウントのAPIキーの取得、テストアカウント(専用のAPIキーがあります)の作成に取り組むことができます。


関連ドキュメント

OAuthの利用

OAuthクイックスタートガイド

非公開アプリ(英語)