구성원 생성

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Media Connect Center의 구성원을 생성하는 API입니다. 고객은 이 API를 통해 고객사의 구성원 정보를 추가할 수 있습니다.

요청

POST https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1/companies/{companyId}/users/{externalKey}

요청 헤더

항목 필수 여부 설명
x-ncp-apigw-timestamp Y 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-timestamp:{Timestamp}
x-ncp-iam-access-key Y 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Y Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code N 리전 코드 (KR)
x-ncp-region_code:KR
Content-Type Y 요청 Body Content Type을 application/json으로 지정
Content-Type: application/json

요청 Path 파라미터

파라미터 타입 크기 필수 여부 설명
companyId String 36 Y 연동키(CompanyId)
Developers > 기본 설정 > 연동키
externalKey String 36 Y 구성원 외부키

요청 Body 파라미터

파라미터 타입 크기 필수 여부 설명
name String 100 Y 구성원명
i18nNames Map N 구성원 다국어명
Map<Locale, String> i18nNames
deptExternalKey string 100 N 부서 외부키
jobGradeExternalKey string 100 N 직급 외부키
jobPositionExternalKey string 100 N 직책 외부키
emailAddr string 100 Y 업무메일(login ID)
telNo string 100 N 전화번호(ex: KR+82 0212345678)
{iso3316}{E.164} {phoneNumber}
cphNo string 100 N 휴대전화번호(ex: KR+82 01012345678)
{iso3316}{E.164} {phoneNumber}
localeTypeCd string N 로캘 정보
tmznTypeCd string N 타임존 정보

요청 예시

POST /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/users/user01
Host: ncloudmcc.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-V2: yaJreXdymUbNIxAltcWUju4/VaUn3JP3rqqzglT4KZs=
x-ncp-apigw-timestamp: 1700457005026
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR

{
    "name":"홍길동",
    "i18nNames": 
    {
        "ko_KR": "홍길동",
        "en_US": "Hong Gil Dong",
    },
    "deptExternalKey":"dept01",
    "jobGradeExternalKey":"jg02",
    "jobPositionExternalKey":"jp03",
    "emailAddr":"aaa@bbb.com",
    "telNo": "KR+82 021234567",
    "cphNo":"KR+82 01012345678",
    "localeTypeCd": "ko_KR",
    "tmznTypeCd":"Asia/Seoul"
}

응답

응답 예시

HTTP/1.1 201 Created
Content-Length: 0
Connection: keep-alive
Date: Mon, 20 Nov 2023 04:41:35 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 6aeb16oqj2e353gp9p6dh68d1m