Grind away: 본인 인증을 기다리는 동안 담당자가 계속 전화한다면: 등본 승인 대기 화면 만들기

2026년 11월 5일 목요일

본인 인증을 기다리는 동안 담당자가 계속 전화한다면: 등본 승인 대기 화면 만들기

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

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

반복 업무가 생기는 장면

서류 접수 담당자가 고객에게 인증 알림이 왔는지 반복해서 묻는 가상 상황입니다. 고객은 이미 승인했지만 관리 화면에는 파일 도착 여부만 보이기 때문에 같은 연락이 이어집니다.

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

이번 연동에서 해결할 문제

에이픽 인증 요청의 transactionId와 신청 건을 연결하고, 서비스 화면에는 승인 대기와 결과 준비를 구분해 보여줍니다. 이 상태 화면과 알림 정책은 서비스에서 구현하는 기능이며 APICK의 자동 고객 연락 기능을 뜻하지 않습니다.

요청 버튼을 여러 번 눌러도 진행 중인 작업을 보여주는 서버 측 제어를 둡니다. 결과 조회를 기다리는 동안 인증 요청을 새로 반복하지 않습니다.
고객의 승인 행위는 고객에게 남깁니다. 상담원이 대신 승인하거나 인증 정보를 메신저로 받아 처리하는 방식으로 만들지 않습니다.
공식 가이드의 업무 상태를 확인하고 거절·만료는 별도 안내로 전환합니다. 대기 화면을 없애기 위해 실패 건을 완료로 바꾸지 않습니다.

빈 회원가입 양식. 개인정보 입력이나 가입 실행 결과가 아닙니다. 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"
      }
    }
  }
}

HTTP 200은 문서가 준비됐다는 보장이 아닙니다. 실제 상태와 결과 준비 여부를 확인한 뒤 발급문서 처리 단계로 이동합니다. 정적 JSON 예시는 결과 일부의 구조를 보여줄 뿐 대기 상태의 전체 정의를 대체하지 않습니다.

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

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

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

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

도입 후 확인할 변화

줄일 작업은 승인 확인 전화와 반복 접수입니다. 사용자가 승인하는 시간과 기관 처리 시간을 제외한 업무시간을 따로 재야, 시스템 연동으로 줄어든 부분을 과장 없이 알 수 있습니다.

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

확인한 공식 자료

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

Grind away