ホストされたデータレイヤーAPIエンドポイント

これは、現行のTealiumホストデータレイヤーAPIの古いバージョンです。

アップロード

ホストされたデータレイヤーオブジェクトをアップロードします。

POST /v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

POSTの代わりにPUTを使用すると、405 Method Not Allowedエラーが発生します。

cURLリクエスト

cURL -i -b JSESSIONID={session_id} -X POST -H "Content-Type: application/json" \
  https://api.tealiumiq.com/v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token} \
  -d @{dl_id}.json

cURLコマンドを使用して-dパラメータにファイルを渡すとき、ファイル名は@文字で始まる必要があります。

例のレスポンス

ステータス201 OK

{
   "status": "pending"
}

変更がTealiumのサーバーに反映されるまでに5から10分かかる場合があります。ステータスが完了と表示されるまで、同じdl_idに対して別の呼び出しを試みるのを待ちます。

エラーメッセージ

405 Method not allowed

このエラーは、アップロードを実行するためにPOSTの代わりにPUTを使用したときに発生します。

{
   "returnCode" : 1464,
   "message" : "Resource already exists. Updates are not permitted via this type of request."
}

400 Bad request

以下のいずれかが真の場合、このエラーが発生します：

• JSONキーにピリオドが含まれている
• アカウント、プロファイル、およびdl_idの組み合わせが250文字を超えている
• dl_idに制限された文字が含まれている
• ユーザーが適切な権限を持っていない
• アカウント/プロファイル名に誤字がある
• リクエストボディが空である
• 不正または無効なJSON
• JSONデータが1メビバイト（MiB）を超えている

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Please check supplied parameters or request body."
}

401 Unauthorized

このエラーは、ユーザーが適切な権限を持っていないか、アカウント/プロファイル名に誤字がある場合に発生します。

{
   "returnCode" : 1469,
   "message" : "although the user is authenticated, the request is denied because of a lack of proper permissions"
}

更新

PUT /v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

POSTの代わりにPUTを使用すると、405 Method Not Allowedエラーが発生します。

cURLリクエスト

cURL -i -b JSESSIONID={session_id} -X PUT -H "Content-Type: application/json" \
  https://api.tealiumiq.com/v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token} \
  -d @{dl_id}.json

例のレスポンス

ステータス200 OK

{
   "status": "pending"
}

変更がTealiumのサーバーに反映されるまでに最大1時間かかる場合があります。ステータスが完了と表示されるまで、同じdl_idに対して別の呼び出しを試みるのを待ちます。

エラーメッセージ

400 Bad request

以下のいずれかが真の場合、このエラーが発生します：

• JSONキーにピリオドが含まれている
• アカウント、プロファイル、およびdl_idの組み合わせが250文字を超えている
• dl_idに制限された文字が含まれている
• ユーザーが適切な権限を持っていない
• アカウント/プロファイル名に誤字がある
• リクエストボディが空である
• 不正または無効なJSON
• JSONデータが1メビバイト（MiB）を超えている

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Please check supplied parameters or request body."
}

404 Not Found

提供されたdl_idが存在しない場合、このエラーが発生します。

{
   "returnCode" : 1404,
   "message" : "Could not locate data layer for supplied params ([account]/[profile]/[dl_id])."
}

削除

DELETE/v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

cURLリクエスト

cURL -i -b JSESSIONID={session_id} -X DELETE -H "Content-Type: application/json" \
  https://api.tealiumiq.com/v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

例のレスポンス

ステータス200 OK

{
   "status": "pending"
}

変更がTealiumのサーバーに反映されるまでに最大1時間かかる場合があります。ステータスが完了と表示されるまで、同じdl_idに対して別の呼び出しを試みるのを待ちます。

エラーメッセージ

404 Not Found

提供されたdl_idが存在しない場合、このエラーが発生します。

{
   "returnCode" : 1404,
   "message" : "Could not locate data layer for supplied params ([account]/[profile]/[dl_id])."
}

400 Bad request

以下のいずれかが真の場合、このエラーが発生します：

• アカウント、プロファイル、およびdl_idの組み合わせが250文字を超えている
• dl_idに制限された文字が含まれている
• ユーザーが適切な権限を持っていない
• アカウント/プロファイル名に誤字がある

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Please check supplied parameters or request body."
}

401 Unauthorized

このエラーは、適切な権限がないか、アカウント/プロファイル名に誤字がある場合に発生します。

{
   "returnCode" : 1469,
   "message" : "although the user is authenticated, the request is denied because of a lack of proper permissions"
}

ステータスの取得

アップロード、更新、削除のアクションのステータスを取得します。ステータスは30日間だけ保持されます。

予想されるステータス値は次のとおりです：

• Pending
• Completed
• Failed

GET /v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

cURLリクエスト

cURL -i -b JSESSIONID={session_id} \
    https://api.tealiumiq.com/v1/dle/accounts/{account}/profiles/{profile}/datalayers/{dl_id}?utk={token}

例のレスポンス

{
   "status": "completed"
}

エラーメッセージ

404 Not Found

提供されたdl_idが存在しないか、提供されたdl_idのステータスが期限切れであるため、30日間の保持期間を超えている場合、このエラーが発生します。

{
   "returnCode" : 1404,
   "message" : "Status unavailable. Please refer to documentation for request status retention period."
}

400 Bad request

以下のいずれかが真の場合、このエラーが発生します：

• アカウント、プロファイル、およびdl_idの組み合わせが250文字を超えている
• dl_idに制限された文字が含まれている
• ユーザーが適切な権限を持っていない
• アカウント/プロファイル名に誤字がある

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Please check supplied parameters or request body."
}

401 Unauthorized

このエラーは、適切な権限がないか、アカウント/プロファイル名に誤字がある場合に発生します。

{
   "returnCode" : 1469,
   "message" : "although the user is authenticated, the request is denied because of a lack of proper permissions"
}

リスト

最大1,000のホストデータレイヤー名のリストを返します。

GET /v1/dle/accounts/{account}/profiles/{profile}/datalayers?utk={token}

cURLリクエスト

cURL -i -b JSESSIONID={session_id} \
  https://api.tealiumiq.com/v1/dle/accounts/{account}/profiles/{profile}/datalayers?utk={token}

例のレスポンス

ステータス200 OK

{
   ["demo_1","demo_2","demo_3"]
}

エラーメッセージ

400 Bad request

このエラーは、適切な権限がないか、アカウント/プロファイル名に誤字がある場合に発生します。

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Please check supplied parameters or request body."
}

400 Bad Request

アカウント/プロファイルに対して1,000以上のホストデータレイヤーが見つかりました。

{
   "returnCode" : 1400,
   "message" : "Invalid request submission. Data layer list size exceeds maximum permissible (1000)."
}

401 Unauthorized

{
   "returnCode" : 1469,
   "message" : "although the user is authenticated, the request is denied because of a lack of proper permissions"
}