コンテンツ・アップデートAPI

コンテンツ・カタログに変更が生じた際、コンテンツ・アップデートAPIを使いコンテンツ・アップデート・リクエストを送信することができます。本番環境に使用されているコンテンツ・カタログは即座に又は直接更新されるわけではありません。更新内容は、クライアントのカタログ・モデルの構築と展開に要する時間に基づき決められたスケジュールに従って本番環境に展開されます。

重要: 必要なパラメーターのみコールしてください。弊社は、多くのアプリケーションやクライアントを同時にサポートするAPIのセットを使用しています。これらのAPIを随時更新または改善される場合があります。

コンテンツ・アップデートAPIを最初からい使用する、またはコンテンツ・アップデートAPIを使用して変更適用のテストを行う場合は、ステージング環境のAPIのインスタンスにリクエストを送信してください。以下のベースURLを使用します:

https://staging-gateway.richrelevance.com/contentupdate/v1

その後、本番環境にリクエストを送信する際にはベースURLの「staging-」を削除してください。

https://gateway.richrelevance.com/contentupdate/v1

このURLのエンドポイントを変えることで、以下を実行することができます。

• {baseUrl}/oauth2/token : その他のエンドポイントの承認とコール
• {baseUrl} : コンテンツの作成と更新

{
"token_type": "bearer",
"access_token": "AABBCCDD"
}

{
"error_description": "Invalid client authentication",
"error": "invalid_client"
}

{
"error_description": "Invalid grant_type",
"error": "unsupported_grant_type"
}

[{
"id": "123",
"name": "Fall Fashion",
"tags": ["fall", "fashion", "sale"],
"rating": "4.0",
"start_date": 2016-08-28,
"end_date": 2016-11-28,
"image_url": ["http://my.cdn.com/path/to/my/image/123.jpg"],
"click_thru": ["http://my.domain.com/path/to/my/cont.../page/123.html"],
"size": ["100"]
},
{
"id": "124",
"name": "Free Shipping",
"tags": ["shipping", "checkout"],
"rating": "3.5",
"start_date": 2016-07-28,
"image_url": ["http://my.cdn.com/path/to/my/image/123.jpg"],
"click_thru": ["http://my.domain.com/path/to/my/cont.../page/123.html"],
"color": ["blue"]
}]

[{
"id": "123",
"tags": ["fall", "fashion", "sale", "limited"]
},
{
"id": "124",
"rating": 3.4,
"click_thru": ["http://my.domain.com/path/to/my/cont...ge/123_v2.html"]
}]

{
"trackingId": "YOUR_TRACKING_ID"
}

{
"error_description": "The access token is invalid or has expired",
"error": "invalid_token"
}

{
  "code": 500,
  "details": "{meaningful parsing exception}",
  "message": "Internal Server Error",
  "status": "error"
}

{
  "code": 400,
  "details": "{}",
  "message": "Bad Request",
  "status": "error"
}