概要
Roktのデータ削除APIは、クライアントがデータ主体の削除リクエストを当社のプラットフォームに送信して管理することを可能にします。これらのAPIは、顧客データとプライバシー規制に関するプロセスを自動化し、より自信を持ってリスクを軽減して実行します。
Roktは、Roktによってホワイトリストに登録された特定のアカウントに対するデータ削除リクエストをサポートしています。アカウントがホワイトリストに登録されていない場合でデータ削除へのアクセスが必要な際は、Roktのアカウントマネージ ャーにお問い合わせください。
機能
データ削除リクエストは、現在Roktの内部システムによって処理される前に15日間キューに保持されます。リクエストのライフサイクルは以下のように説明されます:
削除リクエストは次のようになります:
PENDING
状態でAPIコールを介して作成されます。- 12日後(約288時間)に
READY
状態に移行します。READY
状態になると、内部OPSチームが追加の手動レビューのために通知されます(必要な場合)。
- 3日後(約72時間)に内部システムに渡され、最大15日間内に処理されます - 合計最大プロセス期間は30日となります。
PENDING
またはREADY
状態のときにのみAPIコールを介してキャンセル可能です。ステータスはCANCELLED
に変更され、以降のGET
タスクコールで取得できます。
認証
Roktのデータ削除APIは、EventおよびReporting APIに実装されているのと同じ認証メカニズムを共有しており、詳細は認証手順に記載されています。
APIにアクセスするには、AppIdと関連するAppSecretが 必要です。これらは上記のドキュメントに記載されているとおり、Roktのダッシュボードで生成できます。あるいは、アカウントマネージャーに連絡して、プロセスを案内してもらうこともできます。
API構造
データ削除APIのベースURLは、https://api.rokt.com
です。
現在利用可能なエンドポイントは以下の通りです:
| メソッド | エンドポイント | 目的 | | |--------|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| | POST | /data/deletion-requests/emails | 新しいユーザーデータ削除リクエストを作成します。ユーザーは現在、生のメールアドレス(リスト)、ハッシュ化された(SHA256)メールアドレス(リスト)で識別されます。 | | GET | /data/deletion-requests | 現在の(PENDING, READY)および過去の(ACTIONED, CANCELLED)データ削除リクエストのリストを返し、そのステータスを確認します。 | | DELETE | /data/deletion-requests/:task_id | APIユーザーがREADYおよびPENDING状態のデータ削除リクエストをキャンセルできるようにします。 |
エンドポイント
リクエストの作成
エンドポイント | /data/deletion-requests/emails |
---|---|
メソッド | POST |
クエリパラメータ | なし |
リクエストの例:
{
"accountId": "2456192011195196284677",
"rawEmails": [
"test@test.com"
],
"sha256Emails": [
"kJbnntuJYvQBhPiiHQcz6OSn0EyvzVeOBmtsG2sWkyU="
]
}
レスポンスの例: Http Code 202
注:
- 各削除リクエストには、3つのリストそれぞれに複数のエントリを含めることができます:
rawEmails
およびsha256Emails
. - リクエストが有効であるためには、3つのリストのうち少なくとも1つのエントリを埋める必要があります.
sha256Emails
はbase64エンコーディングで提供する必要があります。
削除リクエストの取得
エンドポイント | /data/deletion-requests |
---|---|
メソッド | GET |
クエリパラメータ | なし |
リクエストの例 | なし |