전체 목록 (총 11 건, p.1)
전체 목록 (총 11건, p.1)
번호 제목
Q1 선거ID(sgId)와 선거종류코드(sgTypecode)는 무엇인가요? 
선거ID(sgId)는 선거일 기준의 고유값(YYYYMMDD 형식)입니다.

예) 제21대 대통령선거? ☞ 20250603

  ▒ 선거종류코드(sgTypecode) ▒ 
　1 : 대통령선거
　2 : 지역구국회의원선거
　3 : 시도지사선거
　4 : 구시군장선거
　5 : 시도의원선거
　6 : 구시군의원선거
　7 : 비례대표국회의원선거
　8 : 광역의원비례대표선거
　9 : 기초의원비례대표선거
　10 : 교육의원선거
　11 : 교육감선거
Q2 API 호출시 필요한 요청변수는 어디서 확인할 수 있나요? 
API 호출에 필요한 요청변수는 「코드정보 오픈API」에서 확인할 수 있습니다.

※ 먼저 선거코드에서 선거ID(sgId)와 선거종류코드(sgTypecode)를 확인한 후,  
　해당 값을 이용하여 구시군, 선거구, 정당, 직업, 학력 코드를 조회할 수 있습니다.

  ▒ 조회 가능한 주요 코드 ▒
    · 선거코드 : 조회 조건 없음
    · 구시군코드 : 선거ID(sgId), 시도명(sdName)
    · 선거구코드 : 선거ID(sgId), 선거종류코드(sgTypecode)
    · 정당코드 : 선거ID(sgId)
    · 직업코드 : 선거ID(sgId)
    · 학력코드 : 선거ID(sgId)
Q3 후보자ID는 어디서 확인하나요? 
후보자ID(huboid)는 「후보자정보 오픈API」를 통해 확인할 수 있습니다.

※ 후보자 조회 시에는 선거ID(sgId), 선거종류코드(sgTypecode), 선거구명(sggName), 시도명(sdName) 등의 조회조건이 필요하며,
　해당 코드값은 「코드정보 API」에서 확인할 수 있습니다.

  ▒ 확인 방법 ▒
    1. 후보자정보 OpenAPI의 후보자 조회 서비스를 선택합니다.
    2. 조회조건을 입력한 후 [미리보기]를 선택합니다.
    3. 조회 결과의 [huboid] 값을 확인합니다.
    4. 필요한 OpenAPI 호출 시 해당 후보자ID(huboid)를 요청변수에 입력하여 사용합니다.
Q4 예비후보자 정보는 언제 조회할 수 있나요? 
예비후보자 정보는 후보자등록 신청일 이전까지 제공합니다.

※ 관련 근거 : 공직선거법 제60조의2 제10항

  ▒ 제공 OpenAPI  ▒ 
    · 예비후보자 정보 (후보자정보  OpenAPI)
    · 예비후보자 선거운동기구 설치내역 (선거운동기구 설치내역 정보 OpenAPI)
    · 예비후보자 사퇴/사망/등록무효 현황 (후보자 사퇴/사망/등록무효 현황 OpenAPI)
Q5 후보자 선거운동기구 설치내역 정보는 언제 조회할 수 있나요? 
후보자 선거운동기구 설치내역 정보는 후보자등록 개시일부터 제공합니다.

※ 관련 근거 : 공직선거법 제61조

  ▒ 제공 OpenAPI ▒
    · 후보자 선거운동기구 설치내역: 선거 종료까지 제공
    · 정당선거사무소 설치내역: 선거일 후 30일까지 제공
Q6 선거공약 정보는 언제 조회할 수 있나요? 
선거공약 정보는 선거 진행 단계에 따라 제공 대상이 달라집니다.

    · 선거 진행 중 : 후보자 공약 정보
    · 선거 종료 후 : 당선인 공약 정보
Q7 투·개표 정보는 실시간으로 제공되나요? 
투·개표 정보는 실시간 제공 데이터가 아닙니다.
선거 종료 후 데이터 검증 절차를 거쳐 통상 2개월 이내 제공합니다.
Q8 선거 종료 후 2개월 이내 제공되는 OpenAPI는 무엇인가요? 
선거 종료 후 데이터 검증 절차를 거쳐 통상 2개월 이내 제공되는 OpenAPI는 다음과 같습니다.

     · 투표결과
     · 개표결과
     · 당선인 정보 
     · 사전투표 정보
     · 무투표선거구 정보 - 무투표선거구 당선인
Q9 API 호출 시 INFO-03(데이터 정보가 없습니다)가 조회됩니다 
다음 사항을 확인해주시기 바랍니다.

    1. 요청변수(선거ID, 선거종류코드, 후보자ID 등)가 정확하게 입력되었는지 확인합니다.
    2. 조회 조건에 맞는 데이터가 존재하는지 확인합니다.
    3. 해당 OpenAPI의 데이터 제공 시점을 확인합니다.
    4. 최근 실시된 선거의 경우 선거일 기준 통상  2개월 이내 제공되는 OpenAPI인지 확인합니다.
        ※ 투표결과 조회, 개표결과 조회, 당선인 정보 조회, 사전투표 정보 조회, 무투표선거구 당선인 조회
Q10 SERVICE_KEY_IS_NOT_REGISTERED_ERROR, APPLICATION_ERROR가 발생합니다. 
다음 오류는 공공데이터포털 서비스키 관련 오류입니다.

    · SERVICE_KEY_IS_NOT_REGISTERED_ERROR
    · APPLICATION_ERROR
    · 인증키 및 호출 오류

해당 오류는 공공데이터포털 문의 채널을 이용하여 문의해주시기 바랍니다.
Q11 공공데이터 오류는 어떻게 신고하나요? 
데이터 내용 오류(값 이상, 누락 등)는
개방포털시스템 → 공공데이터 개방 → 공공데이터 오류 신고
메뉴를 통해 신고해주시기 바랍니다.
문의 시 아래 정보를 함께 제공해주시면 보다 신속하게 확인할 수 있습니다.

    · API명
    · 요청 URL
    · 요청변수 값
    · 오류 메시지