# 계좌 예금주 실명 조회 해당 계좌의 예금주 실명을 확인합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/account_realname 응답 필드 - `data` (object): 조회 데이터 - `data.은행코드` (string): 은행코드 - `data.은행명` (string): 은행명 - `data.계좌번호` (string): 계좌번호 - `data.계좌실명` (string): 예금주 실명. 원천 금융기관 응답을 그대로 전달하며, 은행에 따라 10자까지만 반환되어 뒷부분이 잘릴 수 있습니다. - `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout) - `data.error` (string): 오류메시지 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.ms` (integer): API 응답 시간 - `api.pl_id` (integer): API 결제 로그 ID ## API 요청: POST /rest/account_realname ### 입력 - `account_num` (string, 필수): 계좌번호 (숫자만, 하이픈 제외) - `bank_code` (string, 조건부): 은행코드. bank_name과 둘 중 하나는 필수이며 함께 보내면 bank_code가 우선합니다. - `bank_name` (string, 조건부): 은행명 (예: 국민). bank_code 대신 입력 가능 ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "은행코드": { "type": "string", "description": "은행코드" }, "은행명": { "type": "string", "description": "은행명" }, "계좌번호": { "type": "string", "description": "계좌번호" }, "계좌실명": { "type": "string", "description": "예금주 실명. 원천 금융기관 응답을 그대로 전달하며, 은행에 따라 10자까지만 반환되어 뒷부분이 잘릴 수 있습니다." }, "success": { "type": "integer", "description": "과금 여부0: 실패1: 성공3: 실패(timeout)" }, "error": { "type": "string", "description": "오류메시지" } }, "description": "조회 데이터" }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "API 호출 요금" }, "ms": { "type": "integer", "description": "API 응답 시간" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "은행코드": "004", "은행명": "국민", "계좌번호": "00000123456789", "계좌실명": "홍길동", "success": 1 }, "api": { "success": true, "cost": 60, "ms": 841, "pl_id": 224 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/account_realname' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'account_num=00000123456789' \ --form-string 'bank_name=국민' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("account_num", "00000123456789"); form.append("bank_name", "국민"); const response = await fetch("https://apick.app/rest/account_realname", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("account_num", (None, "00000123456789")), ("bank_name", (None, "국민")), ] response = requests.request("POST", "https://apick.app/rest/account_realname", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '00000123456789', 'bank_name' => '국민', ]; $curl = curl_init('https://apick.app/rest/account_realname'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 계좌실명 길이 제한 계좌실명은 원천 금융기관이 반환한 값을 가공 없이 그대로 전달합니다. 에이픽은 값을 자르거나 늘리지 않습니다. 길이 제한은 은행(조회 기관)별로 다릅니다. 일부 은행은 예금주명을 10자까지만 반환하며, 이 경우 11자 이상인 상호·성명은 뒷부분이 잘려서 전달됩니다. 반면 다른 은행은 10자를 넘는 값도 그대로 반환합니다. 예를 들어 실제 예금주가 (주)비브(viiv)(11자)인데 응답이 (주)비브(viiv(10자)로 오는 경우가 있습니다. 이는 문자 단위로 정확히 잘린 결과이며, 에이픽이 아닌 원천 응답 자체의 한계입니다. 법인·개인, 특수문자 포함 여부로 잘림이 갈리는 것은 아닙니다. 예금주명이 해당 은행의 반환 길이를 넘을 때만 발생합니다. 잘리지 않은 전체 예금주명을 받는 별도 파라미터는 없습니다. 전체 상호가 필요하면 해당 금융기관 조회 채널을 함께 이용하세요. Method URL POST https://apick.app/rest/account_realname 은행 코드 또는 은행명 중 하나는 필수로 입력해야 됩니다. 조회하고자 하는 계좌의 은행이 점검시간일 경우 조회가 불가능합니다. 저축은행(050) 포함 기관 저축은행 계좌는 기관별 코드가 따로 나뉘지 않고 050 하나로 조회됩니다. 아래 79개 저축은행이 모두 050에 포함되며, bank_code=050으로 조회할 수 있습니다. 권역 포함 저축은행 서울 (23개) DB, JT친애, KB, NH, OK, OSB, SBI, 대신, 더케이, 민국, HB, 스카이, 바로, 신한, 애큐온, 예가람, 웰컴, 유안타, 다올, 조은, 키움예스, 푸른, 하나 인천/경기 (19개) JT, 금화, 남양, 모아, 부림, 삼정, 상상인, 세람, 안국, 안양, 영진, 융창, 인성, 인천, 키움, 페퍼, 평택, 한국투자, 한화 부산/경남 (12개) BNK, DH, IBK, 고려, 국제, 동원제일, 솔브레인, 에스앤티, 우리, 조흥, 진주, 흥국 대구/경북/강원 (11개) CK, 대백, 대아, 대원, 드림, 라온, 머스트삼일, 엠에스, 오성, 유니온, 참 광주/전남/전북/제주 (7개) 대한, 라인, 동양, 삼호, 센트럴, 스마트, 스타 대전/충남/충북 (7개) 대명, 상상인플러스, 아산, 우리금융, 오투, 청주, 한성 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터 은행코드 String 은행코드 은행명 String 은행명 계좌번호 String 계좌번호 계좌실명 String 예금주 실명. 원천 금융기관 응답을 그대로 전달하며, 은행에 따라 10자까지만 반환되어 뒷부분이 잘릴 수 있습니다. error String 오류메시지 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "은행코드": "004", "은행명": "국민", "계좌번호": "00000123456789", "계좌실명": "홍길동", "success": 1 }, "api": { "success": true, "cost": 60, "ms": 841, "pl_id": 224 } }