Classic/VPC 환경에서 이용 가능합니다.
구성원을 생성합니다. 구성원이 생성되면 해당 구성원의 이메일 주소로 인증 및 로그인 계정 비밀번호 설정을 위한 초대 메일이 발송됩니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /ncloudmcc/v1/companies/{companyId}/users/{externalKey} |
요청 헤더
Media Connect Center API에서 공통으로 사용하는 헤더에 대한 정보는 Media Connect Center 요청 헤더를 참조해 주십시오.
요청 경로 파라미터
요청 경로 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
companyId |
String | Required | 연동키
|
externalKey |
String | Required | 구성원 외부 키(External Key)
|
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
name |
String | Required | 구성원 이름 |
i18nNames |
Object | Optional | 구성원 다국어 이름 |
i18nNames.{locale} |
String | Optional | 언어별 구성원 이름
|
deptExternalKey |
String | Optional | 부서 외부 키(External Key)
|
jobGradeExternalKey |
String | Optional | 직급 외부 키(External Key)
|
jobPositionExternalKey |
String | Optional | 직책 외부 키(External Key)
|
emailAddr |
String | Required | 이메일 주소(로그인 아이디)
|
telNo |
String | Optional | 전화번호
|
cphNo |
String | Optional | 휴대전화번호
|
localeTypeCd |
String | Optional | 로케일 코드
|
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와 함께 구성원이 생성됩니다.