Viewing job position list
    • PDF

    Viewing job position list

    • PDF

    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
    

    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
    

    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"
            }
        ]
    }
    

    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.