MENU
      Viewing job position list

        Viewing job position list


        Article summary

        Available in Classic and VPC

        It is an API to view the job position list of the Media Connect Center.

        Requests

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

        Request headers

        ItemRequiredDescription
        x-ncp-apigw-timestampYTime elapsed since January 1, 1970, 00:00:00 UTC in milliseconds. The request is considered invalid if the time difference from the API Gateway server is 5 minutes or longer
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYValue of access key ID issued from NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        x-ncp-region_codeNRegion code (KR)
        x-ncp-region_code:KR
        Content-TypeYSpecifies the request body content type as application/json
        Content-Type: application/json

        Request path parameters

        ParametersTypeSizeRequiredDescription
        companyIdString36YIntegration key (CompanyId)
        Developers > Basic settings > Integration key

        Request query parameters

        ParametersTypeSizeRequiredDescription
        limitNumberNMaximum number of items to be returned, default 10
        offsetNumberNOffset of the first item to be returned from the collection, default 0

        Request examples

        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
        Plain text

        Responses

        Response body parameters

        ParametersTypeSizeRequiredDescription
        page.countNumberNumber of items returned
        page.offsetNumberOffset of the first item returned
        page.limitNumberMaximum number of items returned
        page.totalNumberTotal number of items in the collection
        jobPositions[].nameString100Job position name
        jobPositions[].i18nNamesMapMultilingual job position name
        Map<Locale, String> i18nNames
        jobPositions[].sortOrdNumber1Order of job position to be exposed
        jobPositions[].externalKeyString36External key of job position

        Response examples

        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":"team leader",
                    "i18nNames":
                    {
                        "ko_KR":"팀장",
                        "en_US":"Team Leader"
                    },
                    "sortOrd":4,
                    "externalKey":"jp04"
                },
                {
                    "name":"team member",
                    "i18nNames":
                    {
                        "ko_KR":"팀원",
                        "en_US":"Team members"
                    },
                    "sortOrd":5,
                    "externalKey":"jp05"
                }
            ]
        }
        Plain text

        Was this article helpful?

        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.