구성원 생성
- 인쇄
- PDF
구성원 생성
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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
이 문서가 도움이 되었습니까?