고객 구분에서 department(3)가 부서입니다. 그룹 목록의 corporate_type 필터와 같은 값 체계를 사용합니다.
기업 그룹에서만 동작합니다
:user_group_id 가 기업(business) 그룹이 아니면 USER_GROUP_IS_NOT_CORPORATE 로 거절됩니다. 개인 그룹에는 부서가 없습니다.
부서 목록 (관리자용)
활성 상태인 부서 전체를 상세 정보와 함께 돌려줍니다. 관리자 화면에서 부서를 관리할 때 사용합니다. v1 회원 그룹 API 상세 명세에서 관리자용·가입용 인증과 응답을 확인합니다.
curl -X GET "https://api.bootapi.com/v1/user-groups/68b0f2a1c3d4e5f6a7b8c9d0/department" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bash[
{
"user_group_department_id": "68b0f2a1c3d4e5f6a7b8c9d1",
"name": "영업팀",
"member_count": 3,
"use_limit": false,
"limit_month_purchase": 0.0,
"limit_week_purchase": 0.0,
"limit_message": null,
"manager": {
"user_id": "67e4b4425ec892162491d0ec",
"name": "홍길동",
"email": "sales@example.com",
"phone": "01012345678"
}
}
]json| 필드 | 타입 | 설명 |
|---|---|---|
user_group_department_id |
String | 선택 |
name |
String | 선택 |
member_count |
Integer | 선택 |
use_limit |
Boolean | 선택 |
limit_month_purchase |
Number | 선택 |
limit_week_purchase |
Number | 선택 |
limit_message |
String | 선택 |
manager |
Object | 선택 |
부서 목록 (가입용)
기업 회원 가입 화면의 부서 선택 상자에 쓰는 목록입니다. 허용된 쇼핑몰 도메인에서 Bootpay-Client-Key 헤더에 쇼핑몰 clientKey 를 보냅니다. 부트페이 쇼핑몰 도메인에서는 도메인만으로도 쇼핑몰을 식별할 수 있습니다. 회원 JWT 와 secretKey 는 필요 없습니다. 응답에 이름과 ID 만 담깁니다.
{
"departments": [
{ "user_group_department_id": "68b0f2a1c3d4e5f6a7b8c9d0", "name": "영업팀" }
]
}json| 필드 | 타입 | 설명 |
|---|---|---|
user_group_department_id |
String | 선택 |
name |
String | 선택 |
두 엔드포인트의 인증이 다릅니다
관리자용은 서버 키(Basic)와 user:user_group_department_list scope가 필요합니다. 가입용(/public)은 쇼핑몰 clientKey 와 허용된 도메인이 필요합니다. 그래서 공개 응답에는 최소 정보만 담깁니다.
에러 코드
공통 에러
인증·권한 관련 에러는 커머스 API 인증 에러를 참고합니다.
| 코드 | 메시지 | 대처 방법 |
|---|---|---|
USER_ |
그룹을 찾을 수 없습니다 | :user_group_id 가 이 프로젝트의 그룹인지 확인합니다 |
USER_ |
기업 그룹이 아니에요 | 개인 그룹에는 부서를 둘 수 없습니다 |
PROJECT_ |
가입용 API 에 쇼핑몰 식별 정보가 없습니다 | Bootpay-Client-Key 헤더를 확인합니다 |
PROJECT_ |
가입용 API 의 clientKey 를 찾을 수 없습니다 | 쇼핑몰 clientKey 를 확인합니다 |
PROJECT_ |
가입용 API 호출 도메인이 허용되지 않았습니다 | 쇼핑몰에 등록된 허용 도메인에서 호출합니다 |



