진로심리검사(v1)
> 커리어넷 오픈 API > 진로심리검사(v1)
커리어넷의 진로심리검사를 제공합니다.
커리어넷 진로심리검사 API는 이용량에 따라 사용이 제한될 수 있습니다.
기본정보
심리검사 문항 요청 : www.career.go.kr/inspct/openapi/test/questions?apikey=인증키&q=심리검사변수
심리검사 결과 요청 : www.career.go.kr/inspct/openapi/test/report?apikey=인증키&qestrnSeq=심리검사변수
심리검사 문항 요청 (GET method)
| 요청변수 | 타입 | 값 | 설명 |
|---|---|---|---|
| apiKey | String[필수] | OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값 | |
| q | String[필수] | 심리검사번호 | |
| seq | String | 문항번호 | |
| qestnrSeq | String | 심리검사번호 | |
| qesitmNo | String | 문항번호 | |
| relm | String | 영역 | |
| qestn | String | 문항제목 | |
| answer01 | String | 보기1 | |
| answerScore01 | String | 보기1 선택 값 | |
| answer02 | String | 보기2 | |
| answerScore02 | String | 보기2 선택 값 | |
| answer03 | String | 보기3 | |
| answerScore03 | String | 보기3 선택 값 | |
| answer04 | String | 보기4 | |
| answerScore04 | String | 보기4 선택 값 | |
| answer05 | String | 보기5 | |
| answerScore05 | String | 보기5 선택 값 | |
| answer06 | String | 보기6 | |
| answerScore06 | String | 보기6 선택 값 | |
| answer07 | String | 보기7 | |
| answerScore07 | String | 보기7 선택 값 | |
| answer08 | String | 보기8 | |
| answerScore08 | String | 보기8 선택 값 | |
| answer09 | String | 보기9 | |
| answerScore09 | String | 보기9 선택 값 | |
| answer10 | String | 보기10 | |
| answerScore10 | String | 보기10 선택 값 | |
| useAt | String | 사용여부 | |
| registDt | String | 등록일 | |
| registId | String | 등록자 | |
| updtDt | String | 수정일 | |
| updtId | String | 수정자 | |
| tip1Score | String | 보기 설명1 위치 | |
| tip2Score | String | 보기 설명2 위치 | |
| tip1Desc | String | 보기 설명1 | |
| tip2Desc | String | 보기 설명2 | |
| tip3Score | String | 보기 설명3 위치 | |
| tip3Desc | String | 보기 설명3 | |
| URL 생성 > | |||
요청예시
GET https://www.career.go.kr/inspct/openapi/test/questions?apikey=[인증키]&q=[심리검사번호]
결과예시
{
"SUCC_YN": "Y",
"ERROR_REASON": "",
"RESULT": [
{
"question": "몸을 구부리는 동작을 잘 할 수 있다.",
"answer01": "매우낮음",
"answer02": "낮음",
"answer03": "약간낮음",
"answer04": "보통",
"answer05": "약간높음",
"answer06": "높음",
"answer07": "매우높음",
"answer08": null,
"answer09": null,
"answer10": null,
"answerScore01": "1",
"answerScore02": "2",
"answerScore03": "3",
"answerScore04": "4",
"answerScore05": "5",
"answerScore06": "6",
"answerScore07": "7",
"answerScore08": null,
"answerScore09": null,
"answerScore10": null,
"tip1Score": "2",
"tip2Score": "6",
"tip3Score": null,
"tip1Desc": "서서 몸을 앞으로 숙였을 때, 손끝이 발목까지만 닿는다.",
"tip2Desc": "서서 몸을 앞으로 숙였을 때, 손바닥이 쉽게 땅에 닿는다.",
"tip3Desc": null,
"qitemNo": 8
},
{
"question": "힘이 드는 동작을 잘 할 수 있다.",
"answer01": "매우낮음",
"answer02": "낮음",
"answer03": "약간낮음",
"answer04": "보통",
"answer05": "약간높음",
"answer06": "높음",
"answer07": "매우높음",
"answer08": null,
"answer09": null,
"answer10": null,
"answerScore01": "1",
"answerScore02": "2",
"answerScore03": "3",
"answerScore04": "4",
"answerScore05": "5",
"answerScore06": "6",
"answerScore07": "7",
"answerScore08": null,
"answerScore09": null,
"answerScore10": null,
"tip1Score": "2",
"tip2Score": "6",
"tip3Score": null,
"tip1Desc": "무릎 대고 팔굽혀펴기를 5회 이상 하기 어렵다. ",
"tip2Desc": "팔굽혀 펴기를 쉬지 않고 (남자: 50, 여자:20)회 이상 할 수 있다.",
"tip3Desc": null,
"qitemNo": 7
}, ...
]
}
심리검사 결과 요청 (POST method)
문항 결과에 표시된 답변의 선택만 가능하며 아래 코드표를 참고하여 작성하시면 됩니다.
| 요청변수 | 타입 | 값 | 설명 |
|---|---|---|---|
| apikey | String[필수] | OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값 | |
| qestrnSeq | String[필수] | 아래 코드표 참고 | 심리검사번호 |
| trgetSe | String[필수] | 아래 코드표 참고 | 검시자 타입 |
| gender | String[필수] | 아래 코드표 참고 | 성별코드 |
| school | String | 문자 25자이내 | 학교명 |
| grade | String[필수] | 학년 | |
| startDtm | String[필수] | timestamp | 검사시작일시 |
| answers | String[필수] | 아래 코드표 참고 | 답변 (답변 예시에 맞는 방식으로 입력해야 합니다. 주관식인 경우 답변 내에 띄어쓰기가 없어야 합니다.) |
요청예시
POST https://www.career.go.kr/inspct/openapi/test/report
Content-Type: application/json
{
"apikey": "",
"qestrnSeq": "20",
"trgetSe": "100206",
"gender": "100323",
"school": "율도중학교",
"grade": "2",
"startDtm": 1550466291034,
"answers": "1=5 2=7 3=3 4=7 5=1 6=2 7=1 8=5 9=5 10=1 11=4 12=4 13=5 14=4 15=4 16=4 17=4 18=5 19=1 20=1 21=1 22=5 23=3 24=6 25=3 26=2 27=2 28=6 29=3 30=2 31=4 32=3 33=5 34=2 35=3 36=2 37=7 38=2 39=5 40=5 41=5 42=1 43=7 44=6 45=5 46=4 47=2 48=5 49=4 50=5 51=5 52=5 53=7 54=2 55=6 56=4 57=6 58=4 59=3 60=5 61=5 62=5 63=7 64=4 65=7 66=5"
}
결과예시
{
"SUCC_YN": "Y",
"ERROR_REASON": "",
"RESULT": {
"inspctSeq": 38918021,
"url": "https://www.career.go.kr/inspct/web/psycho/vocation/report?seq=Mzg5MTgwMjE"
}
}
심리검사 코드표
| 심리검사명 | 검사번호 | 대상코드 | 답변예제 |
|---|---|---|---|
| 직업흥미검사(K) – 중학생 | 30 | 100206 | 1=3 2=2 3=2 … |
| 직업흥미검사(K) – 고등학생 | 31 | 100207 | 1=3 2=2 3=2 … |
| 진로개발준비도검사 | 8 | 100208 / 100209 / 100210 / 100214/ 100215 | 2,2,2,3,3,2,3,… |
| 이공계전공적합도검사 | 9 | 100208 / 100209 / 100210 / 100214/ 100215 | 2,2,2,3,… |
| 주요능력효능감검사 | 10 | 100208 / 100209 / 100210 / 100214/ 100215 | 2,2,2,3,… |
| 진로흥미탐색 - 초등학생 | 19 | 100205 | 1=5 2=4 3=5 4=5 5=4 … |
| 진로개발역량 - 초등학생 | 32 | 100205 | 1=5 2=4 3=5 4=5 5=4 … |
| 직업적성검사 - 중학생 | 20 | 100206 | 1=5 2=4 3=5 4=5 5=4 … |
| 직업적성검사 - 고등학생 | 21 | 100207 | 1=5 2=4 3=5 4=5 5=4 … |
| 진로성숙도검사 - 중학생 | 22 | 100206 | 1=5 2=4 3=5 4=5 5=4 … |
| 진로성숙도검사 - 고등학생 | 23 | 100207 | 1=5 2=4 3=5 4=5 5=4 … |
| 직업가치관검사 - 중학생 | 24 | 100206 | 1=1 2=4 3=5 … |
| 직업가치관검사 - 고등학생 | 25 | 100207 | 1=1 2=4 3=5 … |
| 직업가치관검사 - 일반,대학생 | 6 | 100208 / 100209 / 100210 / 100214/ 100215 | B1=1 B2=4 B3=5 … |
| 진로개발역량검사 - 중학생 | 26 | 100206 | 1=1 2=4 3=5 … |
| 진로개발역량검사 - 고등학생 | 27 | 100207 | 1=1 2=4 3=5 … |
| 코드분류 | 필드명 | 값 | 설명 |
|---|---|---|---|
| 대상 | trgetSe | 100205 | 초등학생 |
| 100206 | 중학생(14~16세 청소년) | ||
| 100207 | 고등학생(17~19세 청소년) | ||
| 100208 | 대학생 | ||
| 100209 | 일반 | ||
| 100210 | 일반(학부모) | ||
| 100214 | 교사 | ||
| 100215 | 교사(상담) | ||
| 성별 | gender | 100323 | 남자 |
| 100324 | 여자 |