{"openapi":"3.0.3","info":{"title":"APICK 도메인/IP 위치 조회","version":"1.0.0","description":"도메인 또는 IP의 위치 정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/location":{"post":{"summary":"도메인/IP 위치 조회","description":"도메인 또는 IP의 위치 정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"geo":{"type":"object","properties":{"ip":{"type":"string","description":"data.ip와 같은 값입니다."},"country":{"type":"string","description":"국가 코드 2자리(ISO 3166-1)입니다. 예: KR, US, JP."},"code":{"type":"string","description":"행정구역 코드입니다. 제공하지 않으며 항상 빈 문자열입니다."},"lat":{"type":"number","description":"추정 위도입니다. 알 수 없으면 null입니다.","nullable":true},"long":{"type":"number","description":"추정 경도입니다. 알 수 없으면 null입니다.","nullable":true},"net":{"type":"string","description":"통신사(ISP) 또는 IP를 쓰는 조직 이름입니다. 알 수 없으면 빈 문자열입니다."},"r1":{"type":"string","description":"시도입니다. 국내 IP는 한글 이름(예: 서울특별시), 해외 IP는 영문 이름입니다. 알 수 없으면 빈 문자열입니다."},"r2":{"type":"string","description":"시군구(도시)의 영문 이름입니다. 예: Jung-gu. 알 수 없으면 빈 문자열입니다."},"r3":{"type":"string","description":"읍면동입니다. 제공하지 않으며 항상 빈 문자열입니다."}}},"ip":{"type":"string","description":"실제로 위치를 조회한 IPv4 주소입니다. 도메인을 보냈다면 그 도메인의 IP입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer","description":"결제 기록 번호입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"조회할 도메인 또는 IP 주소입니다. 프로토콜·경로는 빼고 호스트만 입력하며, IP는 IPv4 형식을 사용합니다. (string)","example":"168.126.63.1"}},"required":["address"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["알 수 없는 이유로 실패했습니다.","424","address가 비었거나, IPv4·도메인 형식이 아니거나, 도메인에 연결된 IP가 없거나, 위치를 찾지 못한 경우입니다. 입력을 확인한 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}