본문 바로가기 주메뉴 바로가기 푸터 바로가기

실시간 검색어

기상청 홈페이지

GYEONGSANGBUK-DO YOUTH 경북청년포털

회원가입

OPEN API 명세서

OPEN API 명세서

경상북도 청년정책 목록 조회

  • 요청 URL

    https://gbyouth.co.kr/openapi/policy/list.json

    ※ 비정상적인 API 호출 발견 시 API 이용이 제한될 수 있습니다.
    ※ 예상 사용량이 많은 경우 대표번호로 연락하여 담당자와 협의하시기 바랍니다.

  • 요청 파라미터

    파라미터명 설명 타입 비고
    apiKey API 키(필수) String API 신청 내역에서 승인된 API 키 입력
    searchYear 연도 String 4자리(예:2022)
    searchPolicyNm 정책명 String 정책명 검색조건(LIKE)
    searchPolicyType 정책유형 String 구분자 콤마(,)로 다중선택가능(예:YTH0040001,YTH0040002)
    일자리(창업): YTH0040009
    일자리(취업): YTH0040010
    건강: YTH0040001
    교육: YTH0040002
    금융: YTH0040003
    문화: YTH0040004
    복지: YTH0040005
    주거비 지원: YTH0040006
    주택공급: YTH0040007
    참여: YTH0040008
    searchRgnSe 지역 String 구분자 콤마(,)로 다중선택가능(예:PLA0020001,PLA0020002)
    경상북도: PLA0010001 포항시: PLA0020001
    경주시: PLA0020002 김천시: PLA0020003
    안동시: PLA0020004 구미시: PLA0020005
    영주시: PLA0020006 영천시: PLA0020007
    상주시: PLA0020008 문경시: PLA0020009
    경산시: PLA0020010 군위군: PLA0020011
    의성군: PLA0020012 청송군: PLA0020013
    영양군: PLA0020014 영덕군: PLA0020015
    청도군: PLA0020016 고령군: PLA0020017
    성주군: PLA0020018 칠곡군: PLA0020019
    예천군: PLA0020020 봉화군: PLA0020021
    울진군: PLA0020022 울릉군: PLA0020023
    instNo 연관기관번호 String 권한부서에 등록된 기관으로 검색
    기관 목록 조회 API의 기관고유번호
    deptNo 연관부서번호 String 권한부서에 등록된 부서로 검색
    (deptNo 사용시 instNo은 사용불가)
    부서 목록 조회 API의 부서고유번호
    pageIndex 페이지번호 Integer default: 1
    recordCount 결과 표출건수 Integer default: 10
    pageSize 페이지 수 표출건수 Integer default: 10
    pagingYn 페이징 여부 String Y: 페이징 사용(default)
    N: 전체 데이터 출력
    searchDsplyYn 노출 여부 String default: Y
    all: 모든 데이터 출력
    Y: 노출 처리 데이터 출력
    N: 미노출 처리 데이터 출력
  • 출력결과(JSON)

    파라미터명 설명 타입 비고
    success 성공여부 boolean
    msg API 조회 결과 메시지 String
    resultList 청년정책 목록 데이터 JSON
    no 고유번호 Integer
    policyYr 연도 String
    rgnSeNm 지역명 String
    policyTypeNm 정책유형명 String
    sprvsnInstNm 주관기관 String
    operInstNm 운영기관 String
    policyNm 정책명 String
    policyBgngYmd 운영시작일 Date
    policyEndYmd 운영종료일 Date
    policyScl 지원규모 String
    policyCn 정책내용 String
    policyEnq 문의 String
    aplyYn 온라인 신청여부 String 여: Y
    aplyBgngDt 온라인 신청 시작일 Date 온라인 신청여부 Y인 경우에만 값 전달
    aplyEndDt 온라인 신청 종료일 Date 온라인 신청여부 Y인 경우에만 값 전달
    aplyPsbltyYn 현재 신청가능여부 String 가능: Y, 불가능: N
    dtlLinkUrl 상세링크 String
    dsplyYn 노출 여부 String 노출: Y, 미노출: N
    crtDt 등록일시 Date
    updtDt 수정일시 Date
    paginationInfo 페이지 정보 JSON
    currentPageNo 현재 페이지 번호 Integer
    recordCountPerPage 결과 표출건수 Integer
    pageSize 페이지 수 표출건수 Integer
    totalRecordCount 전체 결과 건수 Integer
    totalPageCount 전체 페이지 수 Integer
    firstPageNo 첫번째 페이지 번호 Integer
    lastPageNo 마지막 페이지번호 Integer
    firstPageNoOnPageList 페이지리스트 내 첫번째 페이지 번호 Integer
    lastPageNoOnPageList 페이지리스트 내 마지막 페이지 번호 Integer

기관 목록 조회

  • 요청 URL

    https://gbyouth.co.kr/openapi/inst/list.json

    ※ 비정상적인 API 호출 발견 시 API 이용이 제한될 수 있습니다.
    ※ 예상 사용량이 많은 경우 대표번호로 연락하여 담당자와 협의하시기 바랍니다.

  • 요청 파라미터

    파라미터명 설명 타입 비고
    apiKey API 키(필수) String API 신청 내역에서 승인된 API 키 입력
    srchInstNm 기관명 String 키워드 검색
  • 출력결과(JSON)

    파라미터명 설명 타입 비고
    success 성공여부 boolean
    msg API 조회 결과 메시지 String
    resultList 기관 목록 데이터 JSON
    no 고유번호 Integer
    instNm 기관명 String
    crtDt 등록일시 Date
    deptCnt 부서 개수 Integer

부서 목록 조회

  • 요청 URL

    https://gbyouth.co.kr/openapi/dept/list.json

    ※ 비정상적인 API 호출 발견 시 API 이용이 제한될 수 있습니다.
    ※ 예상 사용량이 많은 경우 대표번호로 연락하여 담당자와 협의하시기 바랍니다.

  • 요청 파라미터

    파라미터명 설명 타입 비고
    apiKey API 키(필수) String API 신청 내역에서 승인된 API 키 입력
    instNo 기관고유번호 String 기관정보의 고유번호
  • 출력결과(JSON)

    파라미터명 설명 타입 비고
    success 성공여부 boolean
    msg API 조회 결과 메시지 String
    resultList 부서 목록 데이터 JSON
    no 고유번호 Integer
    instNm 기관명 String
    deptNm 부서명 String
    crtDt 등록일시 Date