役職リストの照会
- 印刷する
- PDF
役職リストの照会
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC環境で利用できます。
Media Connect Centerの役職リストを照会する APIです。
リクエスト
GET https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1/companies/{companyId}/job-grades
リクエストヘッダ
| 項目 | 必須有無 | 説明 |
|---|---|---|
| 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 > 基本設定 > 連携キー |
リクエスト Queryパラメータ
| パラメータ | タイプ | 容量 | 必須有無 | 説明 |
|---|---|---|---|---|
| limit | Number | N | 返される最大項目数、デフォルト10 | |
| offset | Number | N | コレクションから返される最初の項目のオフセット、デフォルト0 |
リクエスト例
GET /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/job-grades?limit=2&offset=3
Host: ncloudmcc.apigw.ntruss.com
x-ncp-apigw-signature-v2: +4kkeJ+hRUcWH4xsXDQvuDEzfpqDRPr4D+Gc+GnFPHo=
x-ncp-apigw-timestamp: 1700470912198
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR
レスポンス
レスポンス Bodyパラメータ
| パラメータ | タイプ | 容量 | 必須有無 | 説明 |
|---|---|---|---|---|
| page.count | Number | 返された項目数 | ||
| page.offset | Number | 返された最初の項目のオフセット | ||
| page.limit | Number | 返された最大項目数 | ||
| page.total | Number | コレクション内の全項目数 | ||
| jobGrades[].name | String | 100 | 役職名 | |
| jobGrades[].i18nNames | Map | 役職の多言語名Map<Locale, String> i18nNames | ||
| jobGrades[].sortOrd | Number | 1 | 役職の表示順序 | |
| jobGrades[].externalKey | String | 36 | 役職の外部キー |
レスポンス例
HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Date: Mon, 20 Nov 2023 09:01:52 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 68e9pckqm4c356coj1ckpjicpo
{
"page":
{
"count":2,
"offset":3,
"limit":2,
"total":6
},
"jobGrades":
[
{
"name":"課長",
"i18nNames":
{
"ko_KR":"과장",
"en_US":"Manager",
},
"sortOrd":3,
"externalKey":"jg03"
},
{
"name":"代理",
"i18nNames":
{
"ko_KR":"대리",
"en_US":"Deputy",
},
"sortOrd":4,
"externalKey":"jg04"
}
]
}
この記事は役に立ちましたか?