Open 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": ""
    }
                        

심리검사 문항 요청 결과예시 설명표 - 항목, 예시값, 설명

항목	예시값	설명
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"}],
    "gender":"100323",
    "grade":"1",
    "qno":33,
    "school":"",
    "startdtm":1707389537857,
    "trgetse":"100206"
    }
        

심리검사 결과 요청 요청예시 설명표 - 항목, 예시값, 설명

항목	예시값	설명
apikey		OPENAPI 등록 신청 후 관리자로부터 발급받은 KEY값
qno	33/34	심리검사번호
gender	100323(남자)/100324(여자)	검사자 성별
grade		학년
school		학교명
startDtm	1707389537857	시작일시
trgetSe	100206 (중학생) / 100207 (고등학교)	검사구분
answers		검사답변
no		문항번호
val		선택값/입력값

결과 예시

    {
        "result": {
            "inspct": {
                "enddtm": "2024-02-29T00:28:21.000+00:00",
                "school": null,
                "grade": "1",
                "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": ""
    }
    

심리검사 결과 요청 결과예시 설명표 - 항목, 예시값, 설명

항목	예시값	설명
success		응답여부
message		오류메세지
result		응답
inspct		검사정보
endDtm		검사완료일
grade		검사학년
qestnrseq		검사구분번호
inspctseq		검사결과번호
reporturl		검사결과표url
id		회원번호
trgetse		검사구분
school		검시자학교
sexdstn		검사성별