役職照会

Classic/VPC環境で利用できます。

Media Connect Centerの役職を照会する APIです。

リクエスト

GET 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パラメータ

パラメータ	タイプ	容量	必須有無	説明

リクエスト例

GET /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/job-grades/jg01 
Host: ncloudmcc.apigw.ntruss.com
x-ncp-apigw-signature-v2: pv21zbIj+DfOB01bMqRQP8704TegUQZIeXXxSDvyGpU=
x-ncp-apigw-timestamp: 1700461922685
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR

レスポンス

レスポンス Bodyパラメータ

パラメータ	タイプ	容量	説明
jobGrade.name	String	100	役職名
jobGrade.i18nNames	Map		役職の多言語名 `Map<Locale, String> i18nNames`
jobGrade.sortOrd	Number	1	役職の表示順序
jobGrade.externalKey	String	36	役職の外部キー

レスポンス例

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Date: Mon, 20 Nov 2023 06:32:02 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 30e1mc8sm8c9g3ed1k64s62dr3

{
    "jobGrade":
    {
        "name":"部長",
        "i18nNames":
        {
            "ko_KR": "부장",
            "en_US": "Director"
        },
        "sortOrd":0,
        "externalKey":"jg01"
    }
}