공공기관 API 문서를 OpenAPI로 변환하기
공공데이터포털의 활용가이드, 행정·금융 기관의 연계 기술문서는 대부분 HWP나 Word로 배포됩니다. OpenAPI 명세를 주는 곳은 드물고, 수십 개 오퍼레이션의 요청·응답 항목 표를 손으로 옮겨야 연동이 시작됩니다.
pdf2api에 문서를 올리면(HWP는 PDF/Word로 저장 후 업로드) 오퍼레이션·파라미터·인증키 구조를 추출해 OpenAPI 3.1 스펙과 Postman 컬렉션으로 만들어 줍니다.
공공 API 문서의 전형적인 패턴
공공기관 기술문서는 양식이 비슷해 보여도 기관마다 표기가 제각각입니다. 추출기는 다음 패턴들을 전제로 설계됐습니다:
- •요청/응답 항목을 한 표에 합쳐 둔 명세표 — 입출력 분리 복원
- •serviceKey 등 인증 파라미터의 위치(쿼리/헤더) 자동 감지
- •XML/JSON 동시 지원 응답의 스키마 분리
- •결과코드 표(00, 01, 22, 30…)를 응답 명세로 변환
- •페이지네이션 규약(pageNo/numOfRows/totalCount) 인식
HWP 문서는 이렇게
HWP 원본은 직접 업로드 대상이 아닙니다 — 한컴오피스나 변환 도구에서 PDF 또는 Word로 저장한 뒤 올리면 동일하게 처리됩니다. 표 구조가 보존되는 PDF 저장을 권장합니다.
변환 후에는 다른 문서와 동일하게: 미리보기 무료, 건당 결제로 전체 스펙·Postman·SDK 초안 내보내기, 원본 파일은 변환 완료 즉시 영구 삭제.
자주 묻는 질문
HWP 파일을 바로 올릴 수 있나요?
아직 직접 지원은 아닙니다. 한컴오피스에서 PDF로 저장(표 보존)한 뒤 업로드하면 동일하게 추출됩니다.
공공데이터포털 OpenAPI는 이미 명세가 있지 않나요?
포털 일부 API는 Swagger를 제공하지만, 상당수는 HWP/Word 활용가이드뿐입니다. 기관 직접 연계(행정망·금융망) 문서는 거의 전부 문서 파일입니다 — 그 영역이 pdf2api의 타깃입니다.
민감한 연계 문서를 올려도 되나요?
업로드 파일은 변환 완료 즉시 영구 삭제되며 보관·재사용되지 않습니다. 다만 기관 보안 규정상 외부 업로드가 금지된 문서는 규정을 우선하세요.
활용가이드 표 옮겨 적기, 오늘로 끝
미리보기 무료 — 오퍼레이션 추출 결과를 먼저 확인하세요.
기술문서 업로드 →