구성원 생성

Prev Next

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

구성원을 생성합니다. 구성원이 생성되면 해당 구성원의 이메일 주소로 인증 및 로그인 계정 비밀번호 설정을 위한 초대 메일이 발송됩니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /ncloudmcc/v1/companies/{companyId}/users/{externalKey}

요청 헤더

Media Connect Center API에서 공통으로 사용하는 헤더에 대한 정보는 Media Connect Center 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
companyId String Required 연동키
  • 콘솔에서 확인: Media Connect Center > Developers > 기본 설정 > 연동키
externalKey String Required 구성원 외부 키(External Key)
  • 구성원 식별을 위한 구분자

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
name String Required 구성원 이름
i18nNames Object Optional 구성원 다국어 이름
i18nNames.{locale} String Optional 언어별 구성원 이름
  • "언어 코드": "값" 형태로 입력
  • 지원 언어 코드: ko_KR | ja_JP | en_US
  • <예시> "ko_KR": "홍길동", "en_US": "Hong Gil Dong"
deptExternalKey String Optional 부서 외부 키(External Key)
jobGradeExternalKey String Optional 직급 외부 키(External Key)
jobPositionExternalKey String Optional 직책 외부 키(External Key)
emailAddr String Required 이메일 주소(로그인 아이디)
  • 해당 이메일 주소로 구성원 생성 후 변경 불가
telNo String Optional 전화번호
  • {ISO 3166-1 국가 코드}+{E.164 국가 번호} {전화번호} 형태로 입력
  • <예시> KR+82 0212345678
cphNo String Optional 휴대전화번호
  • {ISO 3166-1 국가 코드}+{E.164 국가 번호} {전화번호} 형태로 입력
  • <예시> KR+82 01012345678
localeTypeCd String Optional 로케일 코드
  • ko_KR | ja_JP | en_US
tmznTypeCd String Optional 타임존 코드: 타임존 코드

타임존 코드

타임존 코드는 다음과 같습니다.

코드 설명
Pacific/Midway GMT-11:00(MidwayIsland, Samoa)
Pacific/Honolulu GMT-10:00(Hawaii)
Pacific/Marquesas GMT-09:30(Marquesas)
America/Anchorage GMT-09:00(Alaska)
America/Los_Angeles GMT-08:00(PacificTime)
America/Denver GMT-07:00(MountainTime_US/Canada)
America/Chicago GMT-06:00(CentralTime_US/Canada)
America/New_York GMT-05:00(EasternTime_US/Canada)
America/Caracas GMT-04:30(Caracas)
America/Santiago GMT-04:00(Santiago)
America/St_Johns GMT-03:30(Newfoundland)
America/Sao_Paulo GMT-03:00(SaoPaulo)
America/Noronha GMT-02:00(Mid-Atlantic)
Atlantic/Azores GMT-01:00(Azores)
Europe/London GMT+00:00(GreenwichMeanTime_London)
Europe/Berlin GMT+01:00(Amsterdam,Berlin, Vienna)
Europe/Athens GMT+02:00(Athens, Cairo)
Asia/Baghdad GMT+03:00(Moscow, Baghdad)
Asia/Tehran GMT+03:30(Tehran)
Asia/Baku GMT+04:00(Baku, Muscat)
Asia/Karachi GMT+05:00(Karachi)
Asia/Colombo GMT+05:30(NewDelhi,Mumbai, Colombo)
Asia/Katmandu GMT+05:45(Katmandu)
Asia/Dhaka GMT+06:00(Astana, Dhaka)
Asia/Rangoon GMT+06:30(Rangoon)
Asia/Bangkok GMT+07:00(Bangkok, Hanoi,Jakarta)
Asia/Shanghai GMT+08:00(Beijing,Dalian, Singapore, Taiwan)
Asia/Seoul GMT+09:00(Seoul)
Asia/Tokyo GMT+09:00(Tokyo, Fukuoka)
Australia/Darwin GMT+09:30(Darwin,Adelaide)
Australia/Sydney GMT+10:00(Guam,Canberra, Sydney)
Australia/Lord_Howe GMT+10:30(LordHoweIsland)
Pacific/Noumea GMT+11:00(NewCaledonia)
Pacific/Norfolk GMT+11:30(NorfolkIsland)
Pacific/Auckland GMT+12:00(Auckland,Fiji)

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://ncloudmcc.apigw.ntruss.com/ncloudmcc/v1/companies/2b64fc1e-6e9c-40dc-8b40-991bcaada5ef/users/hg-user001' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "홍길동",
    "i18nNames": {
        "ko_KR": "홍길동",
        "en_US": "Hong Gil Dong"
    },
    "deptExternalKey": "hg-tw-cd",
    "jobGradeExternalKey": "hg-grade-4",
    "jobPositionExternalKey": "hg-pstn-6",
    "emailAddr": "gdong@ncloud.com",
    "telNo": "KR+82 021234567",
    "cphNo": "KR+82 01012345678",
    "localeTypeCd": "ko_KR",
    "tmznTypeCd": "Asia/Seoul"
}'

응답

응답 형식을 설명합니다.

응답 상태 코드

Media Connect Center API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Media Connect Center 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 성공 시 201 Created와 함께 구성원이 생성됩니다.