Classic/VPC環境で利用できます。
Media Connect Centerの役職を作成する APIです。顧客はこの APIを通じて、顧客会社の役職情報を追加できます。
リクエスト
POST https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1/companies/{companyId}/job-grades/{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 | NAVERクラウドプラットフォームポータルで発行された 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 | 役職の表示順序 |
リクエスト例
POST /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/job-grades/jg01
Host: ncloudmcc.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-V2: 1HobWoMrc6q8l+e2+JBoVCWemCpZ6H2BT0siFwnedMo=
x-ncp-apigw-timestamp: 1700455295095
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR
{
"name":"部長",
"i18nName":
{
"ko_KR": "부장",
"en_US": "Director"
},
"sortOrd":0
}
レスポンス
レスポンス例
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