KOREA WAR ARCHIVE CENTER

OpenAPI

6·25전쟁 아카이브 OpenAPI 서비스

서비스 소개

전쟁기념사업회에서는 6·25전쟁 아카이브에 공개된 소장자료 정보를 외부에서 활용할 수 있도록 OpenAPI 서비스를 제공합니다.
발급받은 인증 토큰(token)과 등록된 IP를 통해 인증하며, JSON 형식으로 결과를 받을 수 있습니다.

이용 안내

API를 이용하기 위해서는 인증 토큰(token)이 필요합니다. 아래 절차에 따라 신청해 주세요.

1 Q&A 게시판에서 문의 구분을 'API 문의'로 선택하여 활용 목적과 함께 신청
2 관리자 검토 후 인증 토큰 및 허용 IP 또는 URL 등록
3 발급받은 토큰으로 API 호출

Q&A 게시판으로 이동

API 명세

기본 정보
요청 URL https://www.koreanwar.or.kr:8443/openapi/pbrcList.do
요청 방식 GET
응답 형식 JSON
인증 방식 토큰(token) + IP 또는 URL 인증
요청 변수 (Request Parameter)
변수명 필수 기본값 설명
token O - 발급받은 인증 토큰
page 1 조회할 페이지 번호
pageSize 10 한 페이지당 결과 건수 (최대 100)
sj - 제목 검색어 (부분 일치 검색)
응답 구조 (Response)
필드명 설명
resultCode 결과 코드 (OK, FAIL, ERROR)
resultMsg 결과 메시지
totalCount 전체 자료 건수
page 현재 페이지 번호
pageSize 한 페이지당 건수
list 소장자료 목록 (배열)
소장자료 항목 필드 (list 배열 내 항목)
필드명 설명
archRfcd아카이브 참조코드
sj제목
engSj영문 제목
spln부제
stmt설명
prdcPrsn생산자
prdcPlce생산 장소
prdcBegnDtm생산 시작일
prdcEdDtm생산 종료일
prdcNat1생산 국가1
prdcNat2생산 국가2
obtnPlce입수 장소
obtnSe입수 구분
obtnBegnDtm입수 시작일
obtnEdDtm입수 종료일
cstdLc보관 위치
useCnd이용 조건
kogl공공누리 유형
cpyrYn저작권 여부
olinYn원문 온라인 제공 여부
depth1Nm ~ depth6Nm분류 체계 (1~6단계)
clSystCd분류 체계 코드
pbrcTp1자료 유형
gthrNm수집처명
gthrType수집 유형

에러 코드

resultCode resultMsg 설명
OK 정상 처리되었습니다. 요청 성공
FAIL 인증에 실패했습니다. 토큰 또는 IP/URL을 확인하세요. 토큰이 유효하지 않거나 등록되지 않은 IP 또는 URL에서의 요청
ERROR 서버 오류가 발생했습니다. 서버 내부 오류

예제 실행

아래 버튼을 클릭하면 테스트용 토큰으로 API 호출 결과를 확인할 수 있습니다.

https://www.koreanwar.or.kr:8443/openapi/pbrcList.do?token=test-token-koreanwar-2026&page=1&pageSize=1

이용 시 유의사항

  • 본 API를 통해 제공되는 자료는 전쟁기념사업회의 공개 소장자료에 한합니다.
  • API를 이용하여 제공받은 자료를 활용할 경우, 출처(KOREAN WAR ARCHIVES, https://www.koreanwar.or.kr)를 반드시 표기해 주시기 바랍니다.
    출처 미표기시 이용이 제한될 수 있습니다.
  • 대량 데이터 수집(크롤링) 등 서비스에 부하를 주는 행위는 제한될 수 있습니다.
  • 토큰별로 페이지 수 및 건수 제한이 적용될 수 있습니다.
  • API 사양은 사전 고지 후 변경될 수 있습니다.