# リアルタイム パーソナライゼーション APIを使用したリアルタイム アクティベーションの作成

このAPIを使用すると、イベントを取り込み、Treasure Dataのリアルタイムシステムからパーソナライゼーションレスポンスを受信できます。

* [前提条件](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#prerequisites)
* [エンドポイントとベースURL](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#endpoints-and-base-urls)
* [ヘッダー](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#headers)
* [パーソナライゼーションAPI定義](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#personalization-api-definition)
* [リクエストボディ](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#request-body)
* [レスポンス](/ja/products/customer-data-platform/real-time/creating-a-real-time-activation-using-the-rest-api#responses)


## 前提条件

リアルタイムパーソナライゼーションAPI呼び出しを正常に行うには、次のことを実行する必要があります:

* Treasure コンソールでリアルタイムサービスにアクセスするためにアカウントを有効にします。
* 設定されたイベントとオファーの詳細な知識を持つWebパーソナライゼーション用のデータベースを設定します。
* 書き込み専用APIキー
* 有効なWebパーソナライゼーショントークン。


## エンドポイントとベースURL

パーソナライゼーションAPIは、これらのベースURLを使用します。

| リージョン | ベースURL |
|  --- | --- |
| US (us01) | https://us01.p13n.in.treasuredata.com |
| Europe (eu01) | https://eu01.p13n.in.treasuredata.com |
| Japan (ap01) | https://ap01.p13n.in.treasuredata.com |


パーソナライゼーションAPIの完全なURLは

{baseURL}/{database}/{table}

例:

`https://us01.p13n.in.treasuredata.com/personalization__database/preferences_table`

## ヘッダー

これらは、API呼び出しに必要なヘッダーです。

| 名前 | 内容 |
|  --- | --- |
| Content-Type
 | ベンダー固有のJSON
application/vnd.treasuredata.v1+json
 |
| WP13n-Token
 | 連結されたトークン
トークンは次の要素を組み合わせて作成されます:
{account id}/{instance id}/{token}
たとえば、アカウントID 1、インスタンスID 8、有効なWebパーソナライゼーショントークンの場合、トークンは次のようにフォーマットされます `1/8/12345789abcdef••••••••••••••••••`
 |
| Authorization
 | Treasure APIキー
`TD1 1/abcdef••••••••••••••••••••••0123456789`
 |


## パーソナライゼーションAPI定義

| HTTP動詞 | リソース | 説明 |
|  --- | --- | --- |
| POST | /{database}/{tables} | リクエストのオファーを取得 |


## リクエストボディ

[進行中: ご容赦ください]

## レスポンス

**204 正常な取り込み**

**400 不正なリクエスト**

* 3000: RTトークンが提供されませんでした(X-Tokenヘッダー)
* 3001: RTトークンが設定にありません
* 3002: RTトークンアカウントが認証されたユーザーアカウントと競合しています
* 3003: RTトークンの形式が無効です
* 3004: 無効なイベントオブジェクト。


**429 リクエストが多すぎます**

* 2003: 制限を超えたことによるKinesisエラー
* 2013: Lambdaの総同時実行数が予約された同時実行数を超えています


**500 内部サーバーエラー**

* 9999: 不明/未診断
* 1001: Treasure APIに到達できないか、タイムアウトしました
* 1002: テーブルAPIに到達できないか、タイムアウトしました
* 1003: Kinesisに到達できないか、タイムアウトしました
* 1004: Lambdaに到達できないか、タイムアウトしました
* 1005: MemoryDBに到達できないか、タイムアウトしました
* 2001: Kinesisストリームが見つかりませんでした
* 2002: Kinesis操作がエラーをスローしました
* 2011: Lambda関数が見つかりませんでした
* 2012: Lambda関数がエラーをスローしたか、レスポンスが処理されませんでした
* 2014: Lambda呼び出しが失敗しました
* 2015: Lambdaリアクター設定にまだトークンがありません
* 2021: MemoryDB操作がエラーをスローしました
* 3010: RTトークンは、トークンが一貫性のない(アカウントまたはリアクターID)リアクターで設定されています