브랜드 운영자 권한 부여

Request

브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.

post

브랜드 대표운영자가 브랜드 내 운영자(기업의 마스터/매니저, 대행사) 권한을 부여 합니다.

• 계정 권한 : 마스터

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

Authorizations

Path parameters

personIdstring · max: 20Required

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

brandIdstring · max: 13Required

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

Body

post

HTTPcURLJavaScriptPython

POST /api/1.1/corp/{personId}/brand/{brandId}/privilege HTTP/1.1
Host: api-qa.rcsbizcenter.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "regPrivileges": [
    {
      "privilegeType": "Agency",
      "id": "text"
    }
  ]
}

❖ request body sample

SubManager 권한부여

{
    "regPrivileges": [
        {
            "privilegeType": "SubManager",
            "id": "lng04152"
        }
    ]
}

Agency 권한부여

{
    "regPrivileges": [
        {
            "privilegeType": "Agency",
            "id": "lng04152"
        }
    ]
}

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"
        }
    ],
    "status": 200
}

400

{
    "error": {
        "code": "64104",
        "message": "Invalid personId on path parameter"
    },
    "status": 400
}

{
    "error": {
        "code": "64348",
        "message": "hozzy59 is already registered."
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [privilegeType]"
    },
    "status": 400
}

{
    "error": {
        "code": "64338",
        "message": "invalid value: [privilegeType], SubManager or Agency (case sensitive)"
    },
    "status": 400
}

{
    "error": {
        "code": "64346",
        "message": "user not found: hozzy59"
    },
    "status": 400
}

401

{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}

403

{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}

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