회원 제거

기업 그룹(UserGroup)에 등록된회원(User)을 제거합니다. 제거된 회원이 주문할 경우 기업 그룹내에서는 조회되지 않습니다.

참고 사항

제거된 회원의 이전 주문 내역은 그대로 남아있습니다.
제거된 회원은 다시 그룹에 추가할 수 있습니다.
manager 권한이 필요합니다.

DELETE

https://api.bootapi.com/v1/user-groups/:user_group_id/remove_user

SDK 설치

Server

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

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

API 요청

Server

제거할 회원 정보를 담아 DELETE 요청을 보냅니다.

요청 필드

user_group_idstring필수부트페이에서 발급한 그룹 고유 번호 (URL 경로에 포함)
user_idstring필수부트페이에서 발급한 고객 고유 번호

응답 처리

Server

성공 시 HTTP 200 상태 코드가 반환됩니다. 별도의 응답 데이터는 없습니다.

응답 필드

http_statusintegerHTTP 상태 코드 (성공 시 200)

에러 코드

USER_GROUP_NOT_FOUND

그룹을 찾을 수 없습니다.

user_group_id를 확인하거나 그룹 목록에서 조회하세요.

USER_NOT_FOUND

고객을 찾을 수 없습니다.

user_id를 확인하거나 고객 목록에서 조회하세요.

USER_NOT_IN_GROUP

그룹에 속하지 않은 회원입니다.

해당 회원이 그룹에 속해있는지 확인하세요.

ACCESS_TOKEN_INVALID

유효하지 않은 액세스 토큰입니다.

토큰 발급 API를 통해 새로운 토큰을 발급받으세요.

언어

const { BootpayCommerce } = require('@bootpay/backend-js'); const commerce = new BootpayCommerce({    client_key: '{client_key}',    secret_key: '{secret_key}',    mode: 'development' // 또는 'production'}); const userGroupId = '67e2052b03d0cb4e4117b0af';const userId = '67e2052b03d0cb4e4117b0b1';const response = await commerce.userGroup.removeUser(userGroupId, {    user_id: userId});console.log(response);