{"openapi":"3.0.3","info":{"title":"APICK 주소·좌표 묶음","version":"1.0.0","description":"geo_standardize, geo_reverse, geo_compare_address 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/data_result_address_geo_bundle":{"post":{"summary":"주소·좌표 묶음","description":"geo_standardize, geo_reverse, geo_compare_address 을(를) 한 번의 요청으로 함께 조회합니다. 구성원마다 결과가 성공·실패로 나뉘어 돌아옵니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"product":{"type":"string","description":"묶음 상품 코드(address_geo_bundle)"},"members":{"type":"array","items":{"type":"string"},"description":"이 묶음에 담긴 구성원 코드 목록입니다."},"results":{"type":"object","properties":{"geo_standardize":{"type":"object","properties":{}},"geo_reverse":{"type":"object","properties":{}},"geo_compare_address":{"type":"object","properties":{}}},"description":"성공한 구성원의 응답 본문. 구성원 코드를 키로 담깁니다."},"failures":{"type":"object","properties":{"geo_reverse":{"type":"string"}},"description":"실패한 구성원의 오류. 구성원 코드를 키로, 안내 문구를 값으로 담습니다. 실패가 없으면 빈 객체 {} 입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"성공한 구성원이 하나 이상이면 true 입니다."},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"주소(최대 200자)입니다. 주소 표준화 조회에 씁니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"},"pnu":{"type":"string","description":"필지번호 19자리입니다. 표준화 조회에서 <code>address</code>보다 우선합니다. (string)","example":"…"},"addrType":{"type":"string","description":"주소 유형(<code>auto</code>·<code>parcel</code>·<code>road</code>)입니다. 기본 <code>auto</code>입니다. 가능한 값은 3가지입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다. parcel = 지번 주소를 기준으로 조회하는 값입니다. road = 도로명 주소를 기준으로 조회하는 값입니다. (string)","example":"…"},"includeZipcode":{"type":"string","description":"우편번호 포함 여부입니다. 기본 <code>true</code>입니다. true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)","example":"…"},"x":{"type":"string","description":"경도(-180~180)입니다. 좌표→주소 조회에 <code>y</code>와 함께 씁니다. (number)","example":"…"},"y":{"type":"string","description":"위도(-90~90)입니다. 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)","example":"…"},"point":{"type":"string","description":"<code>경도,위도</code> 문자열입니다. <code>x</code>·<code>y</code> 대신 쓸 수 있습니다. (string)","example":"…"},"addressA":{"type":"string","description":"주소 비교 조회의 첫 번째 주소(최대 200자)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"},"addressB":{"type":"string","description":"주소 비교 조회의 두 번째 주소(최대 200자)입니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"…"}}}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","오류 코드","해결"],"rows":[["구성원 일부가 실패","200","— (failures.<구성원>에 오류 문구)","성공한 구성원 결과는 그대로 받고, 실패한 구성원의 입력을 확인해 다시 요청합니다."],["구성원 전부가 실패","200","— (success: false)","failures 의 안내를 확인해 입력을 고친 뒤 다시 요청합니다."],["이 묶음을 이용할 수 없는 상태","503","NATIVE_BUNDLE_UNAVAILABLE","잠시 뒤 다시 요청합니다. 이 상품을 계속 쓸 수 없으면 문의게시판으로 알려주세요."],["서버 처리 오류","500","NATIVE_BUNDLE_FAILED","잠시 뒤 다시 요청합니다. 반복되면 문의게시판으로 알려주세요."],["/rest/req_<묶음> 으로 호출","400","NATIVE_BUNDLE_NO_AUTH","이 묶음은 인증요청 단계가 없습니다. /rest/data_result_address_geo_bundle 로 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}