한국직업방송 일드림 채...
홈페이지를 통해서 신청...
국가직무능력표준...
한국산업인력공단 윤리헌...

오픈 API 명세서

> 꿈툴(TOOL)집짓기 > 서비스 가이드 > 오픈 API 명세서

  1. 1. 요청 URL
    직업방송 동영상 API를 사용하기 위한 요청 URL은 아래와 같습니다.
    1. 1.1 직업방송동영상 검색
      http://www.worktv.or.kr/openapi/searchm/인증키.do
    2. 1.2 직업방송동영상 재생
      http://www.worktv.or.kr/openapi/playm/인증키.do
    3. 1.3 분류체계 검색
      http://www.worktv.or.kr/openapi/classification/인증키.do
    4. 1.4 직업정보영상분류전체목록
      http://www.worktv.or.kr/openapi/classificationall/인증키.do
    5. 1.5 한국직업방송편성표
      http://www.worktv.or.kr/openapi/guideChart/인증키.do
  2. 2. 요청 파라미터
    직업방송 동영상 API를 사용하기 위한 파라미터 정보는 아래와 같습니다.
    1. 1.1 직업방송동영상 검색
      파라미터명 필수/선택 설명
      query String 선택 동영상을 검색을 원하는 질의, UTF-8 인코딩 입니다.
      dt String (PC 01, 모바일 02) 필수 직업방송 API를 사용하는 서버에 접속한 클라이언트 정보입니다.
      cdType String (기본 1, 2, 3, 4) 선택 분류검색시 검색하는 코드 타입입니다.
      1=직업정보영상분류
      2=진로교육영상분류
      3=학과정보영상분류
      4=기타영상분류
      f1 String 선택 중분류 검색시 중분류 코드값입니다.
      f2 String 선택 소분류 검색시 소분류 코드값입니다.
      f3 String 선택 세분류 검색시 세분류 코드값입니다.
      display Integer (기본 10, 최대 100) 선택 검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다.
      start Integer (기본 1, 최대 1000) 선택 검색의 시작위치를 지정할 수 있습니다. 최대 1000까지 가능합니다.
      order Integer (기본 1, 2) 선택 정렬기준을 부여합니다.
      1 = 등록일자
      2 = 조회수
      sort Integer (기본 1, 2) 선택 정렬방식을 정리합니다.
      1 = 내림차순(desc)
      2 = 오름차순(asc)
      vType String (기본 xml, json) 선택 요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..
      ex) http://www.worktv.or.kr/openapi/searchm/인증키.do?query=worktvamp;dt=01
      ex) http://www.worktv.or.kr/openapi/searchm/인증키.do??cdType=1amp;f1=196amp;dt=01
    2. 1.2 직업방송동영상 상세조회(재생)
      파라미터명 필수/선택 설명
      cid String 필수 직업방송 동영상 검색시 제공되는 동영상 식별키입니다.
      dt String (PC 01, 모바일 02) 필수 직업방송 API를 사용하는 서버에 접속한 클라이언트 정보입니다.
      vType String (기본 xml, json) 선택 요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..
      ex) http://www.worktv.or.kr/openapi/playm/인증키.do?cid=9874amp;dt=02
    3. 1.3 분류체계 검색 / 직업정보영상분류전체목록
      파라미터명 필수/선택 설명
      cdType String (기본 1, 2, 3, 4) 선택 분류검색시 검색하는 코드 타입입니다.
      1=직업정보영상분류
      2=진로교육영상분류
      3=학과정보영상분류
      4=기타영상분류
      f1 String 선택 소분류, 세분류 코드 조회시 부모코드값입니다. 직업정보영상분류 정보조회시만 사용합니다.
      vType String (기본 xml, json) 선택 요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..
      직업정보영상분류 전체코드 조회) http://www.worktv.or.kr/openapi/classificationall/인증키.do
      직업정보영상분류 중분류코드 조회) http://www.worktv.or.kr/openapi/classification/인증키.do
      직업정보영상분류 소분류코드 조회) http://www.worktv.or.kr/openapi/classification/인증키.do?f1=210
      학과정보영상분류코드조회) http://www.worktv.or.kr/openapi/classification/인증키.do?cdType=2
      학과정보영상분류코드조회) http://www.worktv.or.kr/openapi/classification/인증키.do?cdType=3
      기타영상분류코드조회) http://www.worktv.or.kr/openapi/classification/인증키.do?cdType=4
    4. 1.4 직업방송편성표 조회
      파라미터명 필수/선택 설명
      searchDate String (YYYYMMDD) 필수 방송편성표를 조회할 날짜입니다.
      ex) http://www.worktv.or.kr/openapi/guideChart/인증키.do?searchDate=20161115
  3. 3. 응답 데이터 형식
    1. 3.1 공통
      노드명 설명
      <WORKTV> XML문서의 최상위 노드입니다.
      <ERR_CD/> String 에러코드 (애러코드표 참조)
      <PARAMS> String 요청파라미터 정보
      <QUERY/> String 동영상검색 질의어
      <F1/> String 동영상검색 중분류 코드값
      <F2/> String 동영상검색 소분류 코드값
      <DISPLAY/> String 동영상검색 화면출력 갯수
      <START/> String 동영상검색 검색시작위치
      <CID/> String 동영상재생 식별키
      <DT/> String 디바이스유형
      </PARAMS> String 요청파라미터 정보
      <COUNT/> Integer 동영상 총 검색 건수(동영상 검색api에서만 출력됩니다.)
      <ITEM/> 검색내용
      </WORKTV> XML문서의 최상위 노드입니다.
    2. 3.2 직업방송 동영상 검색
      노드명 설명
      <WORKTV> XML문서의 최상위 노드입니다.
      <ERR_CD/> String 에러코드 (애러코드표 참조)
      <PARAMS/> String 요청파라미터 정보
      <COUNT/> Integer 동영상 총 검색 건수(동영상 검색api에서만 출력됩니다.)
      <ITEM> 동영상검색내용
      <CID/> Inteter 동영상 식별번호(동영상 PK)
      <IMG_URL/> String 대표이미지 URL
      <CONTENT_CID_NM/> String 동영상 제목
      <MNG_ORG/> String 관리기관
      <SERVICE_NM/> String 서비스명
      <REG_NM/> String 등록자
      <MAKE_YY/> String(YYYY) 제작년도
      <PRG_KOR_NM/> String 프로그래명 한글명
      <PRG_ENG_NM/> String 프로그래명 영문명
      <CONTENT_CID_SUB_NM/> String 부제목
      <RUN_TIME/> String 상영시간
      <BROAD_NM/> String 방송사
      <BROAD_YYMMDD/> String(YYYYMMDD) 방송일자
      <AUTHOR_NM/> String 작가
      <PD_NM/> String PD
      <ANCHOR_NM/> String 아나운서
      <PRODUCTION_NM/> String 제작사
      <ACTOR_NM/> String 출연자
      <F1_CD/> String 중분류코드
      <F2_CD/> String 소분류코드
      <F1_NAME/> String 중분류코드명
      <F2_NAME/> String 소분류코드명
      <J1_CD/> String 진로교육동영상분류코드
      <J1_NAME/> String 진로교육동영상분류코드명
      <H1_CD/> String 학과정보동영상분류코드
      <H1_NAME/> String 학과정보동영상분류코드명
      <G1_CD/> String 기타동영상분류코드
      <G1_NAME/> String 기타동영상분류코드명
      <NO/> String
      <TOTAL_NO/> String 총편
      <KEYWORD1/> String 검색키워드1
      <KEYWORD2/> String 검색키워드2
      <KEYWORD3/> String 검색키워드3
      <KEYWORD4/> String 검색키워드4
      <KEYWORD5/> String 검색키워드5
      </ITEM> 동영상검색내용
      <ITEM/> 동영상검색내용
      <ITEM/> 동영상검색내용
      </WORKTV> XML문서의 최상위 노드입니다.
    3. 3.3 직업방송 동영상 상세조회(재생)
      노드명 설명
      <WORKTV> XML문서의 최상위 노드입니다.
      <ERR_CD/> String 에러코드 (애러코드표 참조)
      <PARAMS/> String 요청파라미터 정보
      <ITEM> 동영상 상세 조회 내용
      <CID/> Inteter 동영상 식별번호(동영상 PK)
      <IMG_URL/> String 대표이미지 URL
      <CONTENT_CID_NM/> String 동영상 제목
      <MNG_ORG/> String 관리기관
      <SERVICE_NM/> String 서비스명
      <REG_NM/> String 등록자
      <MAKE_YY/> String(YYYY) 제작년도
      <PRG_KOR_NM/> String 프로그래명 한글명
      <PRG_ENG_NM/> String 프로그래명 영문명
      <CONTENT_CID_SUB_NM/> String 부제목
      <RUN_TIME/> String 상영시간
      <BROAD_NM/> String 방송사
      <BROAD_YYMMDD/> String(YYYYMMDD) 방송일자
      <AUTHOR_NM/> String 작가
      <PD_NM/> String PD
      <ANCHOR_NM/> String 아나운서
      <PRODUCTION_NM/> String 제작사
      <ACTOR_NM/> String 출연자
      <F1_CD/> String 중분류코드
      <F2_CD/> String 소분류코드
      <F1_NAME/> String 중분류코드명
      <F2_NAME/> String 소분류코드명
      <J1_CD/> String 진로교육동영상분류코드
      <J1_NAME/> String 진로교육동영상분류코드명
      <H1_CD/> String 학과정보동영상분류코드
      <H1_NAME/> String 학과정보동영상분류코드명
      <G1_CD/> String 기타동영상분류코드
      <G1_NAME/> String 기타동영상분류코드명
      <NO/> String
      <TOTAL_NO/> String 총편
      <KEYWORD1/> String 검색키워드1
      <KEYWORD2/> String 검색키워드2
      <KEYWORD3/> String 검색키워드3
      <KEYWORD4/> String 검색키워드4
      <KEYWORD5/> String 검색키워드5
      <STREAMING_URL/> String RTMP 스트리밍 재생 URL 입니다.
      <IPHONE_STREAMING_URL/> String iphone, ipad, ipod용 RTMP 스트리밍 재생 URL 입니다.
      <DESC/> CDATA 동영상 설명
      </ITEM> 동영상 상세 조회 내용
      </WORKTV> XML문서의 최상위 노드입니다.
    4. 3.3 분류체계 검색
      노드명 설명
      <WORKTV> XML문서의 최상위 노드입니다.
      <ERR_CD/> String 에러코드 (애러코드표 참조)
      <PARAMS/> String 요청파라미터 정보
      <COUNT/> 검색건수
      <ITEM> 분류체계 검색 결과
      <C_ID/> Inteter 분류체계 코드
      <C_NAME/> String 분류체계코드명
      <C_PID/> Inteter 상위분류체계코드
      </ITEM> 분류체계 검색 결과
      <ITEM/> 분류체계 검색 결과
      <ITEM/> 분류체계 검색 결과
      </WORKTV> XML문서의 최상위 노드입니다.
    5. 3.4 방송편성표 검색
      노드명 설명
      <WORKTV> XML문서의 최상위 노드입니다.
      <ERR_CD/> String 에러코드 (애러코드표 참조)
      <PARAMS/> String 요청파라미터 정보
      <COUNT/> 검색건수
      <ITEM> 편성 프로그램
      <PROGRAM_URL/> String 방송프로그램 URL
      <PROGRAM_KEY/> String 프로그램 식별번호(프로그램 PK)
      <PROGRAM_NAME/> String 프로그램명
      <IS_REP_PROGRAM/> String 대표프로그램 여부
      <AIR_TIME/> String
      <AIR_MINUTE/> String
      </ITEM> 편성 프로그램
      </WORKTV> XML문서의 최상위 노드입니다.
  4. 4. Result Code
    1. 4.1 에러코드
      Code description
      WTV-000 API호출 성공
      WTV-001 입력 파라미터 오류
      WTV-002 인증키 오류
      WTV-003 인증키 사용기간 오류
      WTV-004 승인받지 않는 인증기