職位リストの照会
    • PDF

    職位リストの照会

    • PDF

    記事の要約

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

    Media Connect Centerの職位リストを照会する APIです。

    リクエスト

    GET https://ncloudmcc.apigw.ntruss.co/ncloudmcc/v1/companies/{companyId}/job-positions
    

    リクエストヘッダ

    項目必須有無説明
    x-ncp-apigw-timestampY1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYNAVERクラウドプラットフォームポータルで発行された Access Key ID値
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YAccess Key ID値と Secret Keyで暗号化した署名
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    x-ncp-region_codeNリージョンコード(KR)
    x-ncp-region_code:KR
    Content-TypeYリクエスト Body Content Typeを application/jsonに指定
    Content-Type: application/json

    リクエスト Pathパラメータ

    パラメータタイプ容量必須有無説明
    companyIdString36Y連携キー(CompanyId)
    Developers > 基本設定 > 連携キー

    リクエスト Queryパラメータ

    パラメータタイプ容量必須有無説明
    limitNumberN返される最大項目数、デフォルト10
    offsetNumberNコレクションから返される最初の項目のオフセット、デフォルト0

    リクエスト例

    GET /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/job-positions?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.countNumber返された項目数
    page.offsetNumber返された最初の項目のオフセット
    page.limitNumber返された最大項目数
    page.totalNumberコレクション内の全項目数
    jobPositions[].nameString100職位名
    jobPositions[].i18nNamesMap職位の多言語名
    Map<Locale, String> i18nNames
    jobPositions[].sortOrdNumber1職位の表示順序
    jobPositions[].externalKeyString36職位の外部キー

    レスポンス例

    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
        },
        "jobPositions":
        [
            {
                "name":"チームリーダー",
                "i18nNames":
                {
                    "ko_KR":"팀장",
                    "en_US":"Team Leader"
                },
                "sortOrd":4,
                "externalKey":"jp04"
            },
            {
                "name":"チームメンバー",
                "i18nNames":
                {
                    "ko_KR":"팀원",
                    "en_US":"Team members"
                },
                "sortOrd":5,
                "externalKey":"jp05"
            }
        ]
    }
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.