用語 | 内容 |
---|---|
マーケティングプラットフォームAPI | マーケティングプラットフォームが提供するAPIです。 |
クライアントアプリケーション | マーケティングプラットフォームAPIを仕様して作成されたアプリケーションのことです。 |
マーケティングプラットフォームAPIキー | クライアントアプリケーションを特定するためのキーです。 |
パスワード | クライアントアプリケーションを認証するためのパスワードです。 |
秘密鍵 | クライアントアプリケーションとマーケティングプラットフォーム間で共有する秘密鍵です。 |
シグネチャ | マーケティングプラットフォームAPIを第三者に改ざんされていないことを保障するための値(署名)です。 秘密鍵とリクエストパラメータにより作成された値です。 認証トークン「シグネチャ(署名)の仕様参照」 |
認証トークン | 全てのAPIコール時に必要となるアプリケーションの認証用トークンです。 クライアントアプリケーションがマーケティングプラットフォームAPIを利用可能であることを確認するために使用します。 有効期限は発行から1時間です。有効期限が切れた場合は、再度マーケティングプラットフォームから認証トークンを取得する必要があります。 |
コールバックURL | 認証APIを使用した認証後にリダイレクト先を指定するためのURLです。 |
一時トークン | クライアントアプリケーションが認証トークンを取得するための引換券です。有効期限は発行からシステム設定「ログインセッション有効期間(管理者)」「ログインセッション有効期間(リード)」でそれぞれ設定した時間(初期設定は1時間)後となります。有効期限が切れた場合は、再度マーケティングプラットフォームから一時トークンを取得する必要があります。 |
認証ユーザトークン | クライアントアプリケーションがマーケティングプラットフォームで管理されているユーザ(管理者、リード)としてアクセスする場合に、ユーザの特定と認証済みであることを確認するためのトークンです。有効期限はシステム設定「ログインセッション有効期間(管理者)」「ログインセッション有効期間(リード)」でそれぞれ設定した期間後となります。例えば、「ログインセッション有効期間(管理者)」に1時間を設定した場合、有効期限は、管理者ログイン後、最終アクセスから1時間後となります。有効期限が切れた場合は、再度マーケティングプラットフォームから認証ユーザトークンを取得する必要があります。 |