開発者向けサポート

/members/{member_id}/point_records

必要権限

  • privacy

提供メソッド

GET

サンプル
リクエスト
GET members/1/point_records.json?select=POINT_RECORD_ID,POINT_RECORD_DATE,POINT_RECORD_KBN,PLUS_MINUS_POINT
レスポンス
200 OK

[
	{"POINT_RECORD_ID": 1,"POINT_RECORD_DATE": "2015-05-24 00:00:00","POINT_RECORD_KBN": 1,"PLUS_MINUS_POINT": 2000},
	{"POINT_RECORD_ID": 2,"POINT_RECORD_DATE": "2015-05-24 01:23:45","POINT_RECORD_KBN": 2,"PLUS_MINUS_POINT": 500}
]
リクエスト文説明
クエリーパラメータ

select
取得する列名を指定します。指定しない場合は POINT_RECORD_ID,POINT_RECORD_DATE,POINT_RECORD_KBN,PLUS_MINUS_POINT,POINT_LIMIT_DATE,ORDER_NO を指定した場合と同じ動作をします。
point_limit
ポイント履歴に紐づく有効期限管理オブジェクトです。配列の形式になります。
ポイント履歴・有効期間管理(V2)オプション使用時のみ取得可能です。詳細はこちらを参照してください。

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

ポイント履歴情報を格納したJSON値を返します。

POST

サンプル
リクエスト
POST members/1/point_records.json

{"POINT_RECORD_DATE": "2015-05-24 00:00:00", "POINT_RECORD_KBN": 2, "PLUS_MINUS_POINT": 100}
レスポンス
200 OK
リクエスト文説明
クエリーパラメータ

data_type
リクエストデータの種別です。指定できる値:multi_insert
ignore_transaction_check
トランザクション使用チェックの有無を設定します。true:トランザクション使用チェックを実施しません。※multi_insertは対応していません

ボディー文字列

リクエストパラメータ "data_type"未設定の場合:
1件のポイント履歴データ登録します。
リクエストパラメータ "data_type" = "update_by_query"の場合:
条件を指定してポイント履歴情報を更新します。(ポイント有効期限のみ更新可能です)
リクエストパラメータ "data_type" = "multi_insert"の場合:
複数行のポイント履歴データ登録します。1度に登録できるのは100件までです。
現在サポートしている対象プロパティは以下の通りです。サポート外のプロパティを設定することはできません。
  • POINT_RECORD_DATE
  • POINT_RECORD_KBN
  • PLUS_MINUS_POINT
  • POINT_LIMIT_DATE
  • ORDER_NO
  • POINT_COMMENT
  • POINT_REVIEW_ID
  • POINT_ADMIN_COMMENT ※ポイント履歴・有効期間管理(V2)オプション:「利用する」の場合使用
  • POINT_LIMITED_TIME_FLG ※ポイント履歴・有効期間管理(V2)オプション:「利用する(会員単位)」の場合のみ使用

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

更新対象行数

DELETE

サンプル
リクエスト
DELETE members/1/point_records.json
レスポンス
200 OK
リクエスト文説明
応答値説明