Tealium V3 API認証
この記事では、Tealium v3 APIの認証情報について説明します。
認証
認証(ログイン)には、Tealium iQタグ管理からのAPIキーが必要です。Tealium APIキーについて詳しくは、APIキーの管理と生成を参照してください。
認証コールには2つのパラメーターがあります:ユーザー名とAPIキー。APIキーは、APIにログインするためのパスワードの代わりに使用されます。APIへの成功したログイン後、認証コールはJWTを返します。これをベアラートークンと呼びます。ベアラートークンは30分間有効で、その後のAPIコールを認証するために使用する必要があります。
各コールごとに新しいベアラートークンを生成しないでください。トークンが期限切れになるまで使用してください。各トークンは30分以内に期限切れになります。この方法でトークンを使用しないと、Tealiumの裁量により認証コールがスロットリングされる可能性があります。
リージョン固有のホスト
認証のレスポンスにはトークンとホストの値が含まれています。
{
"token":"eyJ0[...]kqkpj8vE"
"host": "us-east-1-platform.tealiumapis.com"
}
ホストの値は、リージョン固有の後続のAPIコールで使用する必要があります。例えば、ビジターAPIエンドポイントは次のようになります:
https://us-east-1-platform.tealiumapis.com/v3/visitor/accounts/{account}/profiles/{profile}
cURLリクエスト
次のcURLリクエストは、JWTトークンのAPIキー交換に必要な変数を示しています。URL、ユーザー名、APIキーがエンコードされています。
curl -X POST \
https://platform.tealiumapis.com/v3/auth/accounts/{account}/profiles/{profile} \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'username={email}' \
--data-urlencode 'key={api_key}'
例:リクエスト
curl -X POST \
https://platform.tealiumapis.com/v3/auth/accounts/{account}/profiles/{profile} \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'username=tealium.user@yourdomain.com' \
--data-urlencode 'key=7O4Pjn8tuc0%5B3Nc2)%7DyXJW8EaCuDRA1U8Jn%23p)qc*O94(*ubIeEUz%25%5D%242~)WKlLB'
例:レスポンス
* Trying 10.220.2.176...
* Connected to platform.tealiumapis.com (10.220.2.176) port 443 (#0)
* TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
* Server certificate: *.tealiumiq.com
* Server certificate: DigiCert SHA2 Secure Server CA
* Server certificate: DigiCert Global Root CA
> POST /v3/auth/accounts/{account}/profiles/{profile} HTTP/1.1
> Host: platform.tealiumapis.com
> User-Agent: curl/7.43.0
> Accept: */*
> cache-control: no-cache
> content-type: application/x-www-form-urlencoded
> Content-Length: 127
>
* upload completely sent off: 127 out of 127 bytes
< HTTP/1.1 200 OK
< Date: Wed, 14 Feb 2018 19:04:22 GMT
< Content-Type: application/json
< Content-Length: 893
< Connection: keep-alive
< Cache-Control: no-cache,no-store,must-revalidate
< Pragma: no-cache
< Expires: 0
< X-XSS-Protection: 1;mode=block
< X-NodeId: i-0afb3e9b53ba15930
< X-Version: 1.0.130-SNAPSHOT
< Set-Cookie: rememberMe=deleteMe; Path=/urest_service; Max-Age=0; Expires=Tue, 13-Feb-2018 19:10:41 GMT
<
* Connection #0 to host platform.tealiumapis.com left intact
{
"token":"eyJ0[...]kqkpj8vE"
"host": "us-east-1-platform.tealiumapis.com"
}
最終更新日 :: 2024年July月10日