부서 목록

고객 구분에서 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 호출 도메인이 허용되지 않았습니다 쇼핑몰에 등록된 허용 도메인에서 호출합니다

함께 보기