Media Connect Center의 부서를 생성하는 API입니다. 고객은 이 API를 통해 고객사의 부서 정보를 추가할 수 있습니다.
요청
POST https://ncloudmcc.apigw.fin-ntruss.co/ncloudmcc/v1/companies/{companyId}/depts/{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 |
| sortOrd |
Number |
1 |
Y |
부서 노출 순서 |
| uprDeptExternalKey |
String |
50 |
N |
상위 부서 외부키, 지정하지 않으면 기본 최상위 부서 |
요청 예시
POST /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/depts/dept01
Host: ncloudmcc.apigw.fin-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: ZYPQDU/KSzfXYFubgoLomAwAuOjLV4AEzE3AQuXAA0Y=
x-ncp-apigw-timestamp: 1700454086935
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR
{
"name":"sales",
"i18nNames":
{
"ko_KR":"영업",
"en_US":"Sales"
},
"uprDeptExternalKey": "dept00",
"sortOrd":0
}
응답
응답 Body 파라미터
응답 예시
HTTP/1.1 201 Created
Content-Length: 0
Connection: keep-alive
Date: Mon, 20 Nov 2023 04:13:38 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 6aeb16oqj2e353gp9p6dh68d1m