그룹 생성
기업 그룹(UserGroup)를 생성합니다. 같은 기업에 소속된 여러 사용자를 하나의 그룹으로 묶어, 구독 계약과 결제 내역을 통합 관리할 수 있습니다.
유의사항
- 요청 시
business_number는 필수이며, 중복 여부를 확인합니다. - 중복된 사업자번호가 있으면 요청이 실패합니다.
POST
https://api.bootapi.com/v1/user_groups
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
API 요청
그룹 정보를 담아 POST 요청을 보냅니다.
user_group 필드
필드명
타입
필수
설명
company_name*string
Y
회사명
business_number*string
Y
사업자 등록번호 (10자리)
ceo_namestring
N
대표자명
manager_namestring
N
담당자명
phonestring
N
연락처
emailstring
N
이메일
zipcodestring
N
우편번호
addressstring
N
주소
address_detailstring
N
상세주소
ex_uidstring
N
외부 연동용 고유 ID
3
Server
응답 처리
성공 시 생성된 그룹 정보가 반환됩니다.
응답 필드
필드명
타입
설명
user_group_idstring
생성된 그룹 고유 ID
company_namestring
회사명
business_numberstring
사업자 등록번호
corporate_typeinteger
그룹 유형 (1: 개인, 2: 기업)
statusinteger
상태 (1: 활성)
http_statusinteger
HTTP 상태 코드
에러 코드
USER_GROUP_EXTERNAL_UID_EXIST
이미 존재하는 외부 UID입니다.
ex_uid 값을 확인하거나 다른 값을 사용하세요.
BUSINESS_NUMBER_DUPLICATE
이미 존재하는 사업자 등록번호입니다.
business_number를 확인하거나 기존 그룹을 조회하세요.
ACCESS_TOKEN_INVALID
유효하지 않은 액세스 토큰입니다.
토큰 발급 API를 통해 새로운 토큰을 발급받으세요.
