한국조폐공사_지역사랑상품권_지자체별_판매정책정보

지역사랑상품권 운영대행사들로부터 수집한 카드, 모바일, 지류 상품권에 대한 사용처지역코드, 할인정책적용시작일자, 할인정책적용종료일자, 할인율, 월간구매제한금액 등을 제공한다.아래는 데이터 사용시 참고바랍니다:1) 제공기관코드:코나아이: I0000001한국간편결제진흥원: I0000002신한카드: I0000003한국조폐공사: I0000004KT: I0000005농협은행: I0000006광주은행: I0000007대구은행: I0000008ITS&G: I0000009NICE 정보통신: I0000010KIS 정보통신: I0000011인조이웍스: I0000012부산은행: I0000014비즈플레이:I00000152) 사용처지역코드(5자리):- 행정안전부에서 제공하는 법정동코드(지역코드 10자리) 중, 앞 5자리(시도코드 2자리 + 시군구코드 3자리)를 사용하고 있습니다.- 코드 정보는 참고문서를 확인바랍니다.3) 읍면동코드(8자리):- 행정안전부에서 제공하는 법정동코드(지역코드 10자리)의 앞 8자리(시도 코드 2자리 + 시군구 코드 3자리 + 읍면동 코드 3자리)를 사용하고 있습니다.- 법정동코드는 행정안전부_행정표준코드_법정동코드 API(https://www.data.go.kr/data/15077871/openapi.do)를 활용하여 조회할 수 있습니다.

currentCount data matchCount totalCount 페이지번호 한 페이지 결과 수 데이터 기준일자 법인단순구매가능여부(Y/N) 법인할인구매가능여부(Y/N) 사용처지역코드(숫자5자리) 연간구매제한금액 예외정책여부(Y/N) 월간구매제한금액 일간구매제한금액 제공기관코드(운영대행사 코드) 최대할인제한금액 최대환전제한금액 할인율 할인정책적용시작일자 할인정책적용종료일자

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색값과 기준일자가 일치하는 데이터를 검색=20260101' \
  --data-urlencode '검색값과 사용처지역코드가 일치하는 데이터를 검색=11110' \
  --data-urlencode '검색값과 제공기관코드가 일치하는 데이터를 검색=11110' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '응답 데이터포맷 설정(JSON 또는 XML=값' \
  --data-urlencode 'default: 'JSON')=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색값과 기준일자가 일치하는 데이터를 검색": "20260101",
  "검색값과 사용처지역코드가 일치하는 데이터를 검색": "11110",
  "검색값과 제공기관코드가 일치하는 데이터를 검색": "11110",
  "공공데이터포털에서 받은 인증키": "값",
  "응답 데이터포맷 설정(JSON 또는 XML": "값",
  "default: 'JSON')": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "검색값과 기준일자가 일치하는 데이터를 검색": "20260101",
    "검색값과 사용처지역코드가 일치하는 데이터를 검색": "11110",
    "검색값과 제공기관코드가 일치하는 데이터를 검색": "11110",
    "공공데이터포털에서 받은 인증키": "값",
    "응답 데이터포맷 설정(JSON 또는 XML": "값",
    "default: 'JSON')": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())