고객 정보 변경

등록된 고객의 정보를 수정할 때 사용하는 API입니다.
이름, 이메일, 휴대폰 번호 등의 기본 정보를 변경할 수 있습니다.

PUT

https://api.bootapi.com/v1/users/:user_id

유의사항

변경 대상 고객의 user_id는 필수이며, 존재하지 않는 경우 404 오류가 반환됩니다.
중복된 이메일, 휴대폰 번호 등은 정책에 따라 업데이트가 거부될 수 있습니다.

SDK 설치

Server

서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.

SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.

API 요청

Server

user_id와 변경할 정보를 전달하여 고객 정보를 수정합니다.

요청 파라미터

user_idstring필수고객 고유 번호 또는 외부 고유 ID (ex_uid) (path parameter)
userobject필수변경할 고객 정보 객체

변경 가능한 필드 (user 객체)

namestring고객 이름
phonestring휴대폰 번호
emailstring이메일 주소
telstring유선 전화번호
nicknamestring별명
gendernumber성별 (0: 여자, 1: 남자)
birthstring생년월일 6자리
login_idstring로그인 아이디
login_pwstring로그인 비밀번호
commentstring추가 정보

응답 처리

Server

변경된 User 모델 데이터가 리턴됩니다.

에러 코드

USER_NOT_FOUND

고객을 찾을 수 없습니다.

user_id가 올바른지 확인하세요.

USER_EMAIL_INVALID

이메일 형식이 올바르지 않습니다.

올바른 이메일 형식을 입력하세요.

ACCESS_TOKEN_INVALID

유효하지 않은 Access Token입니다.

Access Token을 다시 발급받으세요.

언어

Node.js SDK 설치

1. npm으로 설치

npm install --save @bootpay/backend-js

2. Import

ES6 Module (권장)

import { BootpayCommerce } from '@bootpay/backend-js'

CommonJS

const { BootpayCommerce } = require('@bootpay/backend-js')

3. 초기화

const commerce = new BootpayCommerce({
    client_key: 'YOUR_CLIENT_KEY',
    secret_key: 'YOUR_SECRET_KEY',
    mode: 'development' // 'production' | 'development' | 'stage'
})

// 토큰 발급
await commerce.getAccessToken()

참고: client_key와 secret_key는 부트페이 관리자에서 확인할 수 있습니다.