Grind away: 등본 접수는 끝났는데 다운로드 폴더는 그대로: 발급문서 보관과 삭제를 함께 설계하기

2026년 11월 5일 목요일

등본 접수는 끝났는데 다운로드 폴더는 그대로: 발급문서 보관과 삭제를 함께 설계하기

에이픽 API 홍보 · 가상 업무 시나리오

실제 고객 후기나 측정한 성과가 아닙니다. 공식 문서에서 확인한 API 구조를 바탕으로 구현 방법을 설명하며, 실제 API 호출·개인정보 조회·문서 발급은 수행하지 않았습니다. 운영 화면과 장부는 자체 구현 예시입니다.

반복 업무가 생기는 장면

입주 서류 검토를 끝낸 뒤에도 담당자 PC, 메신저, 서버 임시 폴더에 같은 등본이 남는 상황을 가정합니다. 자동 발급만 도입하면 파일이 더 빨리 늘어날 뿐 보관 문제는 해결되지 않습니다.

에이픽 공개 홈페이지. 당시 메뉴와 상품 안내를 보여주는 화면입니다. 2026-10-28 보관 화면, 공통 연결 안내용으로 재사용했습니다. 아래 발급 결과와는 별개인 공통 시작 안내입니다.

이번 연동에서 해결할 문제

APICK 결과를 권한이 제한된 저장소에서 처리하고, 업무 목적에 맞는 보관·삭제 기준을 먼저 적용합니다. 법적 보존 의무가 있는지 확인한 뒤 조직의 기준을 정하며 이 글은 특정 보관 일수를 법적 기준으로 제시하지 않습니다.

발급문서 Base64를 오류 로그나 분석 도구에 보내지 않습니다. 인코딩은 암호화나 비식별화가 아니며 원문 PDF로 되돌릴 수 있습니다.
필요한 담당자만 문서에 접근하게 하고 영구 공개 링크를 발급하지 않습니다. 임시 파일·캐시·다운로드 사본도 관리 대상에 포함합니다.
업무 종료 후 삭제 대상과 보존 대상이 구분되는 목록을 만듭니다. 자동 삭제는 법적 보존 요건과 내부 승인 절차를 충족하도록 별도 설계합니다.

빈 회원가입 양식. 개인정보 입력이나 가입 실행 결과가 아닙니다. 2026-10-28 보관 화면, 공통 연결 안내용으로 재사용했습니다. 아래 발급 결과와는 별개인 공통 시작 안내입니다.

apick.app 연결과 서버 준비

apick.app에서 해당 상품의 최신 개발가이드와 이용 조건을 확인합니다. 인증키는 서버 환경변수 APICK_API_KEY로 관리하고 프런트엔드 코드·스크린샷·공유 로그에 넣지 않습니다. 아래 변수는 실제 값이 아닌 표식입니다. 개인정보를 처리할 권한과 필요한 동의·고지를 갖춘 뒤 서버에서만 사용합니다.

공통 개발가이드의 서버 환경변수 준비 화면. 실제 인증키 값은 표시하지 않습니다. 2026-10-28 보관 화면, 공통 연결 안내용으로 재사용했습니다. 아래 발급 결과와는 별개인 공통 시작 안내입니다.

인증 요청 cURL

다음은 공식 명세 기반의 정적 요청 예시입니다. 환경변수를 준비했다고 자동 실행하지 마세요. 대상·권한·금액·인증 방식을 확인한 실제 업무에서만 호출해야 합니다.

# 공식 명세 기반 정적 예시. 실행하지 않았습니다.
curl --fail-with-body --request POST 'https://apick.app/rest/req_resident_registration' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "name=${APICK_NAME}" \
  --form-string "birthDate=${APICK_BIRTH_DATE}" \
  --form-string "phone=${APICK_PHONE}" \
  --form-string "authProvider=${APICK_AUTH_PROVIDER}" \
  --form-string "purposeCd=${APICK_PURPOSE_CD}" \
  --form-string "sido=${APICK_SIDO}" \
  --form-string "sigungu=${APICK_SIGUNGU}"

같은 요청의 결과 확인

인증 요청 응답에서 받은 transactionId를 해당 업무에 연결합니다. 본인 승인이 필요한 단계는 사용자가 직접 처리하며, 결과 준비 상태를 확인하기 전에 완료로 표시하지 않습니다.

# 승인 뒤, 요청 응답의 transactionId로 결과를 확인하는 구조입니다.
curl --fail-with-body --request POST 'https://apick.app/rest/get_resident_registration' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "transactionId=${APICK_TRANSACTION_ID}"

공통 연결 확인용 /rest/info 정적 cURL 예시. 이 글의 발급 API를 실행한 화면이 아닙니다. 2026-10-28 보관 화면, 공통 연결 안내용으로 재사용했습니다. 아래 발급 결과와는 별개인 공통 시작 안내입니다.

정적 응답 일부와 업무 처리

아래는 공식 응답 예시의 일부 필드만 발췌한 설명입니다. 식별값과 문서 원문은 비공개 표식으로 바꿨습니다. 실제 호출 결과가 아니며 전체 응답이나 모든 상태를 나타내지 않습니다.

{
  "data": {
    "result": {
      "residentRegistration": {
        "성명": "[비공개]",
        "발급문서": "[Base64 원문 비공개]",
        "문서파일명": "주민등록표등본.pdf"
      }
    }
  }
}

공식 정적 응답에서는 발급문서와 문서파일명이 전달됩니다. 문서파일명만 안전하게 바꿨다고 파일 본문이 마스킹되지 않습니다. PDF를 취급하는 저장·백업·다운로드 경로 전체를 확인해야 합니다.

동의·문서 종류·비용 확인

등본과 초본은 별도 상품이며 이 글의 코드는 등본 요청·결과 경로입니다. 초본은 req_resident_registration_cho와 get_resident_registration_cho 경로 및 해당 문서 응답 규격을 별도로 적용합니다. purposeCd 용도 코드와 sido·sigungu 주소지 입력은 공식 규격과 실제 동의 범위에 맞춰 확인합니다.

확인한 등본·초본 문서상 각각 인증 요청 20P, 첫 결과 80P입니다. 초본 문서에는 무료 포인트 사용 불가·최소 1회 결제 조건도 명시되어 있습니다. 사용 가능한 포인트 재원·결제 이력 조건은 최신 정책으로 확인합니다. 고객 승인과 기관 처리 시간을 기다리는 과정이 있으므로 전체 작업이 항상 몇 초 또는 몇 분에 끝난다고 보장할 수 없습니다.

HTTP 상태와 업무 상태를 구분하고 승인 대기·준비 중·실패를 따로 표시합니다. 결과를 기다리는 동안 새 인증 요청을 반복하지 않습니다. 거절·만료와 불확실한 결과는 검토 대상으로 남기고, 최신 조회 간격 및 동시처리 제한을 따릅니다.

도입 후 확인할 변화

개선 지표는 발급 건수보다 원본 사본이 남는 위치 수와 불필요한 보관 건수입니다. API가 전달한 문서를 조직이 어떻게 다루는지가 자동화 완성도를 결정합니다.

에이픽 API로 반복 입력을 연결하되, 사람이 결정해야 하는 승인과 예외는 명확히 남겨 보세요.

확인한 공식 자료

명세 확인 기준: 2026-11-05. 이미지 4장은 APICK 공개 화면의 2026-10-28 보관본이며 공통 연결 설명용입니다. 해당 문서의 실발급 화면이나 현재 운영 성과 증거가 아닙니다.

Grind away