부서 목록 | Bootpay 커머스 매뉴얼

고객 구분에서 department(3)가 부서예요. 그룹 목록의 corporate_type 필터와 같은 값 체계를 써요.

:user_group_id 가 기업(business) 그룹이 아니면 USER_GROUP_IS_NOT_CORPORATE 로 거절돼요. 개인 그룹에는 부서가 없어요.

부서 목록 (관리자용)

GEThttps://api.bootapi.com/v1/user-groups/:user_group_id/departmentBasic Auth

활성 상태인 부서 전체를 상세 정보와 함께 돌려줘요. 관리자 화면에서 부서를 관리할 때 써요. 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	선택

부서 목록 (가입용)

GEThttps://api.bootapi.com/v1/user-groups/:user_group_id/department/publicCommerce Client Key

기업 회원 가입 화면의 부서 선택 상자에 쓰는 목록이에요. 허용된 쇼핑몰 도메인에서 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_GROUP_NOT_FOUND`	그룹을 찾을 수 없어요	`:user_group_id` 가 이 프로젝트의 그룹인지 확인해요
`USER_GROUP_IS_NOT_CORPORATE`	기업 그룹이 아니에요	개인 그룹에는 부서를 둘 수 없어요
`PROJECT_CLIENT_KEY_NOT_FOUND`	가입용 API 에 쇼핑몰 식별 정보가 없어요	`Bootpay-Client-Key` 헤더를 확인해요
`PROJECT_CK_NOT_FOUND`	가입용 API 의 clientKey 를 찾을 수 없어요	쇼핑몰 clientKey 를 확인해요
`PROJECT_DO_NOT_PERMIT`	가입용 API 호출 도메인이 허용되지 않았어요	쇼핑몰에 등록된 허용 도메인에서 호출해요

함께 보기

그룹 목록 — corporate_type: 3 으로 부서만 걸러 볼 수도 있어요
그룹 사용자 추가 — 기업 그룹에 사용자를 넣어요. 부서에는 이 API 로 넣을 수 없어요 (USER_GROUP_IS_NOT_CORPORATE)
구매 한도 설정 — 부서 단위 한도