開発者向けサポート

/rankings

ランキング一覧情報です。クエリを使用して検索をすることができます。

必要権限

  • item

提供メソッド

GET

サンプル
リクエスト
GET /rankings.json?select=RANKING_ID,PC_MOBILE_KBN,RANKING,PREVIEW_FLG,AUTH_FLG,RANKING_CD,ITEM_ID
レスポンス
200 OK

[{"RANKING_ID": "1", "PC_MOBILE_KBN": "1", "RANKING": "1", "PREVIEW_FLG": "1", "AUTH_FLG": "1", "RANKING_CD": "カテゴリAランキング", "ITEM_ID": "1"},
{"RANKING_ID": "1", "PC_MOBILE_KBN": "1", "RANKING": "2", "PREVIEW_FLG": "1", "AUTH_FLG": "1", "RANKING_CD": "カテゴリAランキング", "ITEM_ID": "2"},
{"RANKING_ID": "1", "PC_MOBILE_KBN": "1", "RANKING": "3", "PREVIEW_FLG": "1", "AUTH_FLG": "1", "RANKING_CD": "カテゴリAランキング", "ITEM_ID": "3"}]
リクエスト文説明
クエリーパラメータ

select
取得する列名を指定します。指定しない場合は RANKING_ID,PC_MOBILE_KBN,RANKING,ITEM_ID,RANKING_CD,RANKING_NAME,CATEGORY_ID,ITEMPROPERTY_LIST,PREVIEW_FLG,AUTH_FLG を指定した場合と同じ動作をします。
query
検索条件をJSON形式で指定します。詳細はデータアクセスAPIのページの共通パラメータを参照してください。
result_count
検索結果の取得数を指定します。1~100で指定してください。未指定の場合、結果は20件分返します。
page
取得するページ番号 ((page-1)*resultCount)+1件目からpage*resultCount件目までのデータが取得対象となります。未指定の場合は1が指定されたものとして動作します。

応答値説明
ボディー文字列

ランキング情報を格納したJSON値を返します。

POST

サンプル
リクエスト
POST rankings.json?data_type=free

{"RANKING_ID": "1", "PC_MOBILE_KBN": "1", "RANKING": "1", "PREVIEW_FLG": "1", "AUTH_FLG": "1", "RANKING_CD": "カテゴリAランキング", "ITEM_ID": "1"}
レスポンス
200 OK

{"result": "1"}
リクエスト文説明
クエリーパラメータ

data_type
リクエストデータの種別です。指定できる値:free,access,good_seller

ボディー文字列

リクエストパラメータ "data_type" = "free"の場合:
フリーランキング(売上)のランキングデータを登録します。
リクエストパラメータ "data_type" = "access"の場合:
フリーランキング(アクセス)のランキングデータを登録します。
リクエストパラメータ "data_type" = "good_seller"の場合:
売れ筋ランキングデータを登録します。

応答値説明

ここを見た方は他にもこんなページを見ています。