会員変更API

指定した会員の登録情報を編集します。

まずはじめに、「概要」「共通仕様」について、futureshop APIv2についてをご覧ください。

ご注意事項

  • futureshop omni-channelご利用店舗様はご利用いただけません。
  • パスワードの更新はできません。

基本仕様

  • 1会員ずつ会員情報を更新できます。

<目次>

URL

URLにmemberId(会員ID)を指定してリクエストを行って下さい。

https://{APIドメイン}/admin-api/v1/member/{memberId(会員ID)}

HTTPメソッド

PUT

リクエストヘッダー

アクセストークンなどの詳細はアクセストークンによる認証を参照してください。

リクエストボディ(json)

※「文字数」について:ユーザー画面から入力される会員情報とデータをそろえるため、「byte」ではなく「文字数」としております。

prefecture登録内容
出力 出力 出力 出力
HOKKAIDO 北海道 AOMORI 青森県 AKITA 秋田県 IWATE 岩手県
MIYAGI 宮城県 YAMAGATA 山形県 FUKUSHIMA 福島県 IBARAKI 茨城県
TOCHIGI 栃木県 GUNMA 群馬県 SAITAMA 埼玉県 CHIBA 千葉県
KANAGAWA 神奈川県 TOKYO 東京都 YAMANASHI 山梨県 NIIGATA 新潟県
NAGANO 長野県 SHIZUOKA 静岡県 AICHI 愛知県 MIE 三重県
GIFU 岐阜県 TOYAMA 富山県 ISHIKAWA 石川県 FUKUI 福井県
OSAKA 大阪府 KYOTO 京都府 SHIGA 滋賀県 NARA 奈良県
WAKAYAMA 和歌山県 HYOGO 兵庫県 OKAYAMA 岡山県 HIROSHIMA 広島県
YAMAGUCHI 山口県 TOTTORI 鳥取県 SHIMANE 島根県 KAGAWA 香川県
TOKUSHIMA 徳島県 EHIME 愛媛県 KOCHI 高知県 FUKUOKA 福岡県
SAGA 佐賀県 NAGASAKI 長崎県 KUMAMOTO 熊本県 OITA 大分県
MIYAZAKI 宮崎県 KAGOSHIMA 鹿児島県 OKINAWA 沖縄県 OTHER その他
サンプル(リクエストボディ)
{
    "companyName": "フューチャーショップ",
    "companyNameKana": "フューチャーショップ",
    "departmentName": "営業部",
    "departmentNameKana": "エイギョウブ",
    "companyTelNo": "090-1111-2222",
    "companyFaxNo": "080-2222-3333",
    "lastName": "大阪",
    "firstName": "太郎",
    "lastNameKana": "オオサカ",
    "firstNameKana": "タロウ",
    "mail": "test@future-shop.co.jp",
    "mobileMail": "test@docomo.ne.jp",
    "zipCode": "532-0003",
    "prefecture": "OSAKA",
    "address1": "大阪市淀川区宮原",
    "address2": "111",
    "address3": "222",
    "telNoMain": "090-1111-2222",
    "telNoAlternate": "090-2222-3333",
    "faxNo": "06-1111-2222",
    "gender": "UNSPECIFIED",
    "birthday": "2000-10-07",
    "nickName": "ニックネーム",
    "newsletter": "YES",
    "mobileNewsletter": "NO",
    "storeCode": "test",
    "directMail": "NO",
    "remarks": "備考欄",
    "memberStageName": "ブロンズ",
    "memberStageAutoConfig": "ON",
    "additionalItem1": "追加属性項目01",
    "additionalItem2": "追加属性項目02",
    "additionalItem3": "追加属性項目03",
    "additionalItem4": "追加属性項目04",
    "additionalItem5": "追加属性項目05",
    "additionalItem6": "追加属性項目06",
    "additionalItem7": "追加属性項目07",
    "additionalItem8": "追加属性項目08",
    "additionalItem9": "追加属性項目09",
    "additionalItem10": "追加属性項目10",
    "additionalItem11": "追加属性項目11",
    "additionalItem12": "追加属性項目12",
    "additionalItem13": "追加属性項目13",
    "additionalItem14": "追加属性項目14",
    "additionalItem15": "追加属性項目15",
    "additionalItem16": "追加属性項目16",
    "additionalItem17": "追加属性項目17",
    "additionalItem18": "追加属性項目18",
    "additionalItem19": "追加属性項目19",
    "additionalItem20": "追加属性項目20"
}

レスポンス

会員が存在しない場合、404が返却されます。

key 項目名 必須 byte 内容
status ステータス String - 成功:success
失敗:failed
errors エラーリスト Array - リクエストのエラー発生時に出力
code コード String -
path パス String - 入力値エラーの場合、対象のjson位置を出力
message メッセージ String - エラーの概要が出力されます。
エラーコード
コード メッセージ 説明
WrongFormat リクエストデータがjson形式ではありません json形式ではない場合に返却されます。
TooLong companyNameは100文字以内で指定してください companyNameが100文字を超過した場合に返却されます。
TooLong companyNameKanaは100文字以内で指定してください companyNameKanaが100文字を超過した場合に返却されます。
InvalidValue companyNameKanaの指定が不正です 全角カナ・全角英字・半角英字・ハイフン・中点以外の文字が設定されていた場合に返却されます。
TooLong departmentNameは100文字以内で指定してください departmentNameが100文字を超過した場合に返却されます。
TooLong departmentNameKanaは100文字以内で指定してください departmentNameKanaが100文字を超過した場合に返却されます。
InvalidValue departmentNameKanaの指定が不正です 全角カナ・全角英字・半角英字・ハイフン・中点以外の文字が設定されていた場合に返却されます。
InvalidValue companyTelNoの指定が不正です 電話番号の整合性チェックでエラーとなった場合に返却されます。
InvalidValue companyFaxNoの指定が不正です 電話番号の整合性チェックでエラーとなった場合に返却されます。
TooLong lastNameは200文字以内で指定してください lastNameが200文字を超過した場合に返却されます。
TooLong firstNameは200文字以内で指定してください firstNameが200文字を超過した場合に返却されます。
TooLong lastNameKanaは200文字以内で指定してください lastNameKanaが200文字を超過した場合に返却されます。
InvalidValue lastNameKanaの指定が不正です 全角カナ・全角英字・半角英字・ハイフン・中点以外の文字が設定されていた場合に返却されます。
TooLong firstNameKanaは200文字以内で指定してください firstNameKanaが200文字を超過した場合に返却されます。
InvalidValue firstNameKanaの指定が不正です 全角カナ・全角英字・半角英字・ハイフン・中点以外の文字が設定されていた場合に返却されます。
Required mailを指定してください mailのパラメータが設定されていない場合に返却されます。
InvalidValue mailの指定が不正です メールアドレスの整合性チェックでエラーとなった場合に返却されます。
InvalidValue mobileMailの指定が不正です メールアドレスの整合性チェックでエラーとなった場合に返却されます。
InvalidDomain mobileMailのドメインが不正です 以下のドメイン以外を指定した場合に返却されます。
@docomo.ne.jp
@ezweb.ne.jp
@i.softbank.jp
@disney.ne.jp
@d.vodafone.ne.jp
@h.vodafone.ne.jp
@t.vodafone.ne.jp
@c.vodafone.ne.jp
@r.vodafone.ne.jp
@k.vodafone.ne.jp
@n.vodafone.ne.jp
@s.vodafone.ne.jp
@q.vodafone.ne.jp
@softbank.ne.jp
@au.com
DuplicateMail mailとmobileMailに同じ内容は指定できません mailとmobileMailを同じ値を指定した場合に返却されます。
InvalidValue zipCodeの指定が不正です 3桁 -(半角) 4桁以外の指定をした場合に返却されます。
InvalidValue prefectureの指定が不正です ※prefecture登録内容の都道府県コード以外を指定した場合に返却されます。
TooLong address1は100文字以内で指定してください address1が100文字を超過した場合に返却されます。
TooLong address2は100文字以内で指定してください address2が100文字を超過した場合に返却されます。
TooLong address3は100文字以内で指定してください address3が100文字を超過した場合に返却されます。
InvalidValue telNoMainの指定が不正です 電話番号の整合性チェックでエラーとなった場合に返却されます。
InvalidValue telNoAlternateの指定が不正です 電話番号の整合性チェックでエラーとなった場合に返却されます。
InvalidValue faxNoの指定が不正です 電話番号の整合性チェックでエラーとなった場合に返却されます。
InvalidValue genderの指定が不正です 以下の性別コード以外を指定した場合に返却されます。
UNSPECIFIED
MALE
FEMALE
InvalidDateFormat birthdayの日付フォーマットを正しく指定してください 「yyyy-mm-dd」形式ではない場合、または存在しない日付の場合に返却されます。
TooLong nickNameは50文字以内で指定してください nickNameが50文字を超過した場合に返却されます。
InvalidValue newsletterの指定が不正です “YES”、”NO”以外の指定をした場合に返却されます。
InvalidValue mobileNewsletterの指定が不正です “YES”、”NO”以外の指定をした場合に返却されます。
InvalidValue directMailの指定が不正です “YES”、”NO”以外の指定をした場合に返却されます。
TooLong remarksは16,000文字以内で指定してください remarksが16,000文字を超過した場合に返却されます。
InvalidValue memberStageAutoConfigの指定が不正です “ON”、”OFF”以外の指定をした場合に返却されます。
MailAlreadyRegistered mailが重複しています 指定したmailが他の会員が使用している場合に返却されます。
MobileMailAlreadyRegistered mobileMailが重複しています 指定したmobileMailが他の会員が使用している場合に返却されます。
CannotRegisterSameMail mailとmobileMailが重複しています 更新後、mailとmobileMailが同じ値になる場合に返却されます。
StoreCodeNotFound 指定された店舗コードが登録されていません 設定>実店舗店舗>(よく行くお店)一覧>店舗設定-店舗コード【CC未利用・移行中】構築>実店舗設定>新規登録・編集-店舗コードに存在しない店舗コードを指定した場合に返却されます。
MemberStageNotFound 指定された会員ステージが登録されていません 設定>購入者・会員情報>会員ステージ基本設定-会員ステージ設定【CC未利用・移行中】構築>会員管理>会員ステージ基本設定に存在しない会員ステージを指定した場合に返却されます
NotAvailableOnOmniChannel omni-channelご利用店舗では使用できません futureshop omni-channelをご利用頂いている場合に返却されます。

サンプル

サンプル(エラー時)

{
    "status": "failed",
    "errors": [
        {
            "code": "Invalid",
            "path": "storeCode",
            "message": "storeCodeの指定が不正です"
        }
    ]
}

サンプル(成功時)

{
    "status": "success"
}