CareerNet 한국직업능력연구원 커리어넷Open API 센터

진로심리검사(v2)

홈 > 커리어넷 오픈 API > 진로심리검사(v2)

커리어넷의 진로심리검사 중 직업흥미검사(H)를 제공합니다.
커리어넷 진로심리검사 API는 이용량에 따라 사용이 제한될 수 있습니다.


오픈API 신청
오픈 API

기본정보

심리검사 목록 요청 : https://www.career.go.kr/inspct/openapi/v2/tests?apikey={openapi키}

심리검사 문항 요청 : https://www.career.go.kr/inspct/openapi/v2/test?apikey={openapi키}&q={심리검사번호}

심리검사 결과 요청 : https://www.career.go.kr/inspct/openapi/v2/report

심리검사 목록 요청 (GET method)

요청예시

    GET https://www.career.go.kr/inspct/openapi/v2/tests?apikey={openapi키}
항목, 예시값, 설명 표
항목 예시값 설명
apiKey OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값

결과예시

{
"result": [[
    {
        "qno": 33,
        "name": "직업흥미검사(H)",
        "description": "직업과 관련하여 어떤 흥미가 있는지 보다 간편하게 알아볼 수 있습니다.",
        "summary": "흥미란 어떤 종류의 활동에 대해서 개인이 가지고 있는 쾌, 불쾌, 수락, 거부의 경향성을 말하며 특히 직업흥미는 직업의 선택, 직업의 지속, 직업세계의 만족감, 직업에서의 성공등과 밀접히 관련됩니다.
이 검사는 여러분이 어떤 종류의 일에 얼마나 흥미를 느끼고 있는가를 알아봄으로써, 장래에 자신에게 알맞은 직업을 탐색하는데 도움을 주기 위한 것입니다.",
        "maker": "정윤경 선임연구위원, 박동 선임연구위원, 정지은 부연구위원, 김나라 전문연구원, 김민석 연구원(이하 한국직업능력연구원)",
        "exectime": 20,
        "qcount": 146
    },{
        "qno": 34,
        "name": "직업흥미검사(H)",
        "description": "직업과 관련하여 어떤 흥미가 있는지 보다 간편하게 알아볼 수 있습니다.",
        "summary": "흥미란 어떤 종류의 활동에 대해서 개인이 가지고 있는 쾌, 불쾌, 수락, 거부의 경향성을 말하며 특히 직업흥미는 직업의 선택, 직업의 지속, 직업세계의 만족감, 직업에서의 성공등과 밀접히 관련됩니다.
이 검사는 여러분이 어떤 종류의 일에 얼마나 흥미를 느끼고 있는가를 알아봄으로써, 장래에 자신에게 알맞은 직업을 탐색하는데 도움을 주기 위한 것입니다.",
        "maker": "정윤경 선임연구위원, 박동 선임연구위원, 정지은 부연구위원, 김나라 전문연구원, 김민석 연구원(이하 한국직업능력연구원)",
        "exectime": 20,
        "qcount": 145
    }
],
"success": "Y",
"message": ""
}
항목, 예시값, 설명 표
항목 예시값 설명
qno 심리검사번호
name 검사명
description 심리검사 설명
summary 심리검사 요약
maker 검사 제작자
exectime 예상시간
qcount 문항수
success Y/N 요청 성공 여부
message 요청 오류 설명

심리검사 문항 요청 (GET method)

요청예시

GET https://www.career.go.kr/inspct/openapi/v2/test?apikey={openapi키}&q={심리검사번호}
심리검사 문항 요청 표
항목 예시값 설명
apikey OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값
qno 심리검사번호

결과 예시

{
  "result": {
    "summary": "흥미란 어떤 종류의 활동에 대해서 개인이 가지고 있는 쾌, 불쾌, 수락, 거부의 경향성을 말하며 특히 직업흥미는 직업의 선택, 직업의 지속, 직업세계의 만족감, 직업에서의 성공등과 밀접히 관련됩니다.
이 검사는 여러분이 어떤 종류의 일에 얼마나 흥미를 느끼고 있는가를 알아봄으로써, 장래에 자신에게 알맞은 직업을 탐색하는데 도움을 주기 위한 것입니다.",
    "qnm": "직업흥미검사(H)",
    "qno": "33",
    "etime": "20",
    "questions": [
      {
        "no": "1",
        "limit": "1",
        "text": "고장 난 물건 직접 수리하기",
        "choices": [
          {
            "val": "1",
            "text": "매우 싫어한다",
            "type": "M"
          },
          {
            "val": "2",
            "text": "싫어한다",
            "type": "M"
          },
          {
            "val": "3",
            "text": "보통이다",
            "type": "M"
          },
          {
            "val": "4",
            "text": "좋아한다",
            "type": "M"
          },
          {
            "val": "5",
            "text": "매우 좋아한다",
            "type": "M"
          }
        ]
      },
      ...
    ],
    "maker": "정윤경 선임연구위원, 박동 선임연구위원, 정지은 부연구위원, 김나라 전문연구원, 김민석 연구원(이하 한국직업능력연구원)"
  },
  "success": "Y",
  "message": ""
}
항목1, 항목2, 예시값, 설명으로 구성된 표
항목 예시값 설명
qno 심리검사번호
qnm 심리검사명
summary 검사 설명
etime 검사예상시간
maker 검사 제작자
questions 문항정보
no 문항번호
limit 답변갯수(다수인 경우 ,로 구분. 답변에는 공백이 존재할 수 없습니다.
text 문항내용
choices 선택지 정보
val 선택값
text 선택지 내용
type 답변유형(M인 경우 선택, I인 경우 직접입력)
success Y/N 요청 성공 여부
message 요청 오류 설명

심리검사 결과 요청 (POST method)

요청 예시

POST https://www.career.go.kr/inspct/openapi/v2/report
Content-Type: application/json

{
  "apikey": "api 키",
  "answers":[{"no":"1","val":"1"},...,{"no":"120","val":"2"},{"no":"121","val":"1"},{"no":"122","val":"5"},{"no":"123","val":"5"},{"no":"124","val":"5"},{"no":"125","val":"4"},{"no":"126","val":"5"},{"no":"127","val":"3"},{"no":"128","val":"1"},{"no":"129","val":"1"},{"no":"130","val":"2"},{"no":"131","val":"2"},{"no":"132","val":"-"},{"no":"133","val":"국제개발협력전문가"},{"no":"134","val":"소방관"},{"no":"135","val":"미술,과학"},{"no":"136","val":"음악,기타"},{"no":"137","val":"3"},{"no":"138","val":"4"},{"no":"139","val":"4"},{"no":"140","val":"4"},{"no":"141","val":"4"},{"no":"142","val":"3"},{"no":"143","val":"4"},{"no":"144","val":"3"},{"no":"145","val":"4"},{"no":"146","val":"5"}],
  "email":"",
  "gender":"100323",
  "grade":"1",
  "name":"",
  "qno":33,
  "school":"",
  "startdtm":1707389537857,
  "trgetse":"100206"
}
항목1, 항목2, 예시값, 설명으로 구성된 표
항목 예시값 설명
apikey OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값
qno 33/34 심리검사번호
email 이메일 주소
gender 100323(남자)/100324(여자) 검사자 성별
grade 학년
name 이름
school 학교명
startDtm 1707389537857 시작일시
trgetSe 100206 (중학생) / 100207 (고등학교) 검사구분
answers 검사답변
no 문항번호
val 선택값/입력값

결과 예시

{
    "result": {
        "inspct": {
            "enddtm": "2024-02-29T00:28:21.000+00:00",
            "school": null,
            "grade": "1",
            "name": null,
            "qestnrseq": "33",
            "id": "0",
            "inspctseq": "52411195",
            "reporturl": "https://www.career.go.kr/inspct/web/psycho/holland2/report?seq=NTI0MTExOTU",
            "trgetse": "100206",
            "sexdstn": "100323"
        }
    },
    "success": "Y",
    "message": ""
}
항목1, 항목2, 예시값, 설명으로 구성된 표
항목 예시값 설명
success 응답여부
message 오류메세지
result 응답
inspct 검사정보
endDtm 검사완료일
grade 검사학년
name 이름
qestnrseq 검사구분번호
inspctseq 검사결과번호
reporturl 검사결과표url
id 회원번호
trgetse 검사구분
school 검시자학교
sexdstn 검사성별
Copyright ⓒ 2012 CareerNet. All rights reserved.