브랜드 운영 권한 조회

Request

브랜드에 등록된 운영 권한 정보를 조회합니다.

get

https://api-qa.rcsbizcenter.com/api/1.1https://api.rcsbizcenter.com/api/1.1

/corp/{personId}/brand/{brandId}/privilege

브랜드에 등록된 운영 권한 정보를 조회합니다. 브랜드에 등록된 브랜드 대표운영자, 운영자, 권한 지정 대행사 정보를 제공합니다.

• 계정 권한: 마스터, 매니저

• 브랜드 권한: 브랜드 대표운영자, 운영자

Authorizations

jwtAuth

AuthorizationstringRequired

인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.

Path parameters

personIdstring · max: 20Required

maxLength: 20 - 브랜드 대표운영자 또는 운영자의 계정(마스터, 매니저) ID 입니다.

brandIdstring · max: 13Required

maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.

Responses

200

페이지 내 Response 섹션 참조

No content

get

/corp/{personId}/brand/{brandId}/privilege

HTTPcURLJavaScriptPython

GET /api/1.1/corp/{personId}/brand/{brandId}/privilege HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

페이지 내 Response 섹션 참조

No content

Response

필드명	타입	길이	필수여부	기본값	설명
result	array<object>		O		브랜드의 권한 정보 객체입니다.
code	string	5	O	20000000
status	integer	3	O	200
desc	string		O

result - array<object>

필드명	타입	길이	필수여부	기본값	설명
privilegeType	string		O		권한은 다음과 같이 구분됩니다. Manager : 브랜드 관리자(=마스터) SubManager : 브랜드 부관리자(=마스터, 매니저) Agency : 브랜드 대행사
id	string	20	O		마스터, 매니저 또는 대행사의 ID입니다.
status	string		O		권한 처리 상태를 표시합니다. Waiting : RCS Biz Center 웹에서 제공되는 기능인 '브랜드 운영권한 신청'을 이용하여 신청 후 대기 브랜드 관리자의 승인을 대기 중인 상태입니다. Waiting 상태의 대상은 POST를 이용하여 등록하면 승인이 되고 Ok 상태로 변경됩니다. Processing : 권한 정보를 이통3사에 동기화 중인 경우 processing 상태로 표시됩니다. Processing 상태가 짧은 시간 동안 발생할 수 있으며 지속될 경우 RCS Biz Center에 문의하시기 바랍니다. Ok : 권한 상태가 정상적인 경우 표시됩니다.

❖ response body sample

200

{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "privilegeType": "Manager",
            "id": "hong",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy59",
            "contracts": [],
            "status": "Ok"
        },
        {
            "privilegeType": "SubManager",
            "id": "hozzy123",
            "contracts": [],
            "status": "Ok"
        }
    ],
    "status": 200
}

400

401

403

error code는 RCS Biz Center - Response body error code 참조