POST /token/refresh

POST /token/generate エンドポイントで返された有効期限内の Refresh Token を送信して、新しい UID2 token を生成します。

Used by: このエンドポイントは、主にパブリッシャーが使用します。

このエンドポイントは、Client-Side (例えば、ブラウザやモバイルアプリ) から呼び出すことができます。それは、API key を使用する必要がないためです。

注記

このエンドポイントを直接呼び出す代わりに、UID2 SDK のいずれかを使用して管理することができます。オプションの概要については、SDKs: Summary を参照してください。

Request Format

POST '{environment}/v2/token/refresh'

POST /token/generate または POST /token/refresh のレスポンスで返された refresh_token 値の内容を POST body として追加します。

このエンドポイントについて知っておくべきことは、以下のとおりです:

トークン更新のリクエストには暗号化は必要ありません。
リクエストが HTTP ステータスコード 200 で成功すると、新しい UID2 Token または Out-Out 情報が返されます。
成功したレスポンスは、そのレスポンスに新しいトークンまたは Opt-Out 情報が含まれているかどうかにかかわらず暗号化されます。エラーレスポンスは暗号化されません。
レスポンスを復号化するには、このトークンに対する最新の refresh_response_key 値を使用します。refresh_response_key の値は、POST /token/generate と POST /token/refresh のレスポンスで返されます。トークンがリフレッシュされるたびに、新しい refresh_response_key が返されます。現在のレスポンスを復号化するには、必ず最新のものを使用してください。

Path Parameters

Path Parameter	Data Type	Attribute	Description
`{environment}`	string	必須	インテグレーション環境: `https://operator-integ.uidapi.com` 本番環境: `https://prod.uidapi.com` リージョンごとのオペレーターを含む全リストは、Environments を参照してください。 Notes: `integ` 環境と `prod` 環境は異なる API keys を必要とします。トークンの有効期限は変更される可能性がありますが、`integ` 環境では常に `prod` 環境よりも大幅に短くなります。

Testing Notes

POST /token/generate リクエストで以下のパラメータのいずれかを使用すると、常に refresh_token による ID レスポンスが生成され、POST /token/refresh エンドポイントと共に使用するとログアウトレスポンスとなります。

メールアドレス refresh-optout@example.com
電話番号 +00000000002

Request Example

詳細といくつかのプログラミング言語でのコードの例は、リクエストの暗号化とレスポンスの復号化を参照してください。

Decrypted JSON Response Format

復号化された成功したレスポンスには、ユーザーの新しい UID2 Token (advertising_token) と関連する値が含まれるか、ユーザーがオ Opt-Out したことを示します。

注記

レスポンスは、HTTP ステータスコードが 200 の場合のみ暗号化されます。それ以外の場合は、レスポンスは暗号化されません。

このセクションには、次のサンプルレスポンスが含まれています:

Successful Response With Tokens
Successful Response With Opt-Out
Error Response

Successful Response With Tokens

すべての値が有効で、ユーザーが Opt-Out していない場合、レスポンスは成功し、新しい UID2 Token が関連する値とともに返されます。以下の例は、トークンを含む成功したレスポンスを復号したものです:

{
  "body": {
    "advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
    "identity_expires": 1724899014352,
    "refresh_expires": 1724981814352,
    "refresh_from": 1724896314352,
    "refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
    "refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
  },
  "status": "success"
}

Successful Response With Opt-Out

ユーザーが Opt-Out した場合、レスポンスは成功しますが、新しい UID2 Token は返されません。以下の例は、復号化された OptーOut レスポンスを示しています:

{
  "status": "optout"
}

Error Response

エラーレスポンスは以下のようなものになる可能性があります:

{
  "status": "client_error",
  "message": "Client Error"
}

Response Body Properties

レスポンスボディには、次の表に示すプロパティが含まれます。

Property	Data Type	Description
`advertising_token`	string	ユーザーの UID2 token (Advertising Token とも呼ばれます) です。
`refresh_token`	string	UID2 Service と最新の ID トークンのセットを交換できる暗号化されたトークンです。
`identity_expires`	number	UID2 Token の有効期限を示す Unix タイムスタンプ (ミリ秒単位) です。
`refresh_from`	number	SDK for JavaScript (SDK for JavaScript Reference Guide を参照してください) が UID2 Token のリフレッシュを開始するタイミングを示す Unix タイムスタンプ(ミリ秒単位)。 TIP: SDK を使用していない場合は、このタイムスタンプから Advertising Token もリフレッシュすることを検討してください。
`refresh_expires`	number	Refresh Token の有効期限を示す Unix タイムスタンプ(ミリ秒単位)。
`refresh_response_key`	string	POST /token/refresh リクエストでレスポンス復号化のために使用される鍵です。

Response Status Codes

次の表は、status プロパティの値と、それに対応する HTTP ステータスコードの一覧です。

Status	HTTP Status Code	Description
`success`	200	リクエストは成功し、新しい UID2 Token と関連する値がレスポンスとして返されます。レスポンスは暗号化されています。
`optout`	200	ユーザーがオプトアウトした。このステータスは許可されたリクエストに対してのみ返されます。レスポンスは暗号化されます。
`client_error`	400	リクエストに不足している、または無効なパラメータがありました。
`invalid_token`	400	リクエストで指定された `refresh_token` の値が無効です。このステータスは許可されたリクエストに対してのみ返されます。
`expired_token`	400	リクエストで指定された `refresh_token` 値は期限切れのトークンです。
`unauthorized`	401	クエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行するのに許可されていないベアラートークンが含まれていました。

status の値が success または optout 以外であれば、message フィールドにその問題に関する追加情報が表示されます。

Request Format​

Path Parameters​

Testing Notes​

Request Example​

Decrypted JSON Response Format​

Successful Response With Tokens​

Successful Response With Opt-Out​

Error Response​

Response Body Properties​

Response Status Codes​