商品情報の更新を行うAPIです。
出力方法はJsonです。
アイテム情報の更新を行います。即時反映はされず、朝／夜の1日2回の更新タイミングでレコメンドに反映されます。
単一のアイテム情報のみ指定できます。アイテムの項目名を指定しなければその項目の情報は更新されません。
|
パラメタ |
要否 |
説明 |
|
type |
必須 |
処理種別。アイテム情報の更新の場合は setitem を指定 |
|
account |
必須 |
アカウント名 |
|
recommend |
必須 |
レコメンド名 |
|
item |
必須 |
更新したいアイテム情報を配列形式で指定。 |
|
項目名 |
要否 |
説明 |
|
code |
必須 |
アイテムコード。 255文字以内の半角英数字、「-(ハイフン)」、「/(スラッシュ)」、「_(アンダースコア)」を指定 |
|
url |
必須 |
アイテムページのURL。URIエンコード後の文字長が1024文字以内の文字列を指定 |
|
name |
必須 |
アイテム名。255文字以内で指定 |
|
image |
－ |
アイテム画像のURL。URLは255文字以内で指定 |
|
category |
－ |
カテゴリ情報。URIエンコード後の文字長が255文字以内の文字列を指定 |
|
release_date |
－ |
リリース日。 YYYY-MM-DD、YYYY-MM-DD HH:MM:SS、YYYY/MM/DD、YYYY/MM/DD HH:MM:SS のフォーマットのみ利用可能 |
|
dysplay_start |
－ |
掲載開始日。 YYYY-MM-DD、YYYY-MM-DD HH:MM:SS、YYYY/MM/DD、YYYY/MM/DD HH:MM:SS のフォーマットのみ利用可能 |
|
dysplay_end |
－ |
掲載終了日。掲載開始日以降の日付を指定。 YYYY-MM-DD、YYYY-MM-DD HH:MM:SS、YYYY/MM/DD、YYYY/MM/DD HH:MM:SS のフォーマットのみ利用可能 |
|
stock |
－ |
表示なら1以上、非表示なら0を指定。 |
|
その他 |
－ |
ユーザ指定項目。レコメンドで利用したい情報を指定する。最大100個まで登録可能 |
Content-Type: application/json
Authorization: bearer [アクセストークン]
{
"type": "setitem",
"account": [アカウント名],
"recommend": [レコメンド名],
"item": {
"code": [アイテムコード],
"url": [アイテムページのURL],
"name": [アイテム名],
"image": [アイテム画像のURL],
"category": [カテゴリ情報],
"release_date": [リリース日],
"stock": [表示有無],
"jobtype": [職種],（ユーザ任意項目）
"info": [説明],（ユーザ任意項目）
： }
}
"access_token": "187113305cfd78f0afe3dfeb94a3f6b0a1e7ae1410a96abaaa1965477dd4dc16"
https://api.rcmd.jp/connector/items/manageリクエストヘッダには以下をご指定ください。１で取得した access_token はここで利用します。
Content-Type: application/jsonアイテム情報の更新の場合は type に “setitem” をご指定ください。
Authorization: bearer
187113305cfd78f0afe3dfeb94a3f6b0a1e7ae1410a96abaaa1965477dd4dc16
{
"type": "setitem",
"account": "test_account",
"recommend": "test",
“item": {
"code": "testitem",
"url": "http://test.rcmd.jp/products/detail.php?product_id=testitem",
"name": "テストアイテム",
"image": "/upload/save_image/testitem.jpg",
"release_date": "2018/10/31 19:46:00" }
}