Viewing job position

Prev Next

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

Available in Classic and VPC

It is an API to view job positions in the Media Connect Center.

Requests

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

Request headers

Item Required Description
x-ncp-apigw-timestamp Y Time 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-key Y Value of access key ID issued from NAVER Cloud Platform portal
x-ncp-iam-access-key:{Sub Account Access Key}
x-ncp-apigw-signature-v2 Y Signature encrypted with the access key ID value and secret key
x-ncp-apigw-signature-v2:{API Gateway Signature}
x-ncp-region_code N Region code (KR)
x-ncp-region_code:KR
Content-Type Y Specifies the request body content type as application/json
Content-Type: application/json

Request path parameters

Parameters Type Size Required Description
companyId String 36 Y Integration key (CompanyId)
Developers > Basic settings > Integration key
externalKey String 36 Y External key of job position

Request examples

GET /ncloudmcc/v1/companies/48128f23-e29b-496e-aa04-1f741fed86bc/job-positions/jp04
Host: ncloudmcc.apigw.ntruss.com
x-ncp-apigw-signature-V2: m/wRX9v2ZszobfLrbD0i5XVUq3h46OI/l/zZU8DE93s=
x-ncp-apigw-timestamp: 1700462299614
x-ncp-iam-access-key: HrR0s91elfiXEeTSZcwj
x-ncp-region_code: KR

Responses

Response body parameters

Parameters Type Size Required Description
jobPosition.name String 100 Job position name
jobPosition.i18nNames Map Multilingual job position name
Map<Locale, String> i18nNames
jobPosition.sortOrd Number 1 Order of job position to be exposed
jobPosition.externalKey String 36 External 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 06:38:19 GMT
Server: nginx
x-ncp-apigw-response-origin: ENDPOINT
x-ncp-trace-id: 6cor460ojcp9p6ac1k6osj6dhp

{
    "jobPosition":
    {
        "name":"team leader",
        "i18nNames":{
            "ko_KR": "팀장",
            "en_US": "Team Leader"
        },
        "sortOrd":4,
        "externalKey":"jp04"
    }
}