{"openapi":"3.0.3","info":{"title":"APICK IP 변경 이력 조회","version":"1.0.0","description":"도메인에 대한 IP 주소 변경 이력 정보를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/ip_history":{"post":{"summary":"IP 변경 이력 조회","description":"도메인에 대한 IP 주소 변경 이력 정보를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string","description":"도메인이 연결됐던 IPv4 주소입니다."},"location":{"type":"string","description":"그 IP의 위치 표기(영문)입니다. 예: Seoul - South Korea."},"owner":{"type":"string","description":"그 IP를 쓰는 통신사·호스팅 업체 이름(영문)입니다."},"lastseen":{"type":"string","description":"그 IP 연결이 마지막으로 확인된 날짜(YYYY-MM-DD)입니다."}}},"description":"IP 이력 목록입니다. 보통 최근에 확인된 것부터 옵니다. 순서가 중요하면 lastseen으로 직접 정렬하세요."},"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":{"domain":{"type":"string","description":"조회할 도메인입니다. http·https와 경로를 빼고 apick.app처럼 호스트만 입력하세요. (string)","example":"apick.app"}},"required":["domain"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["필수 입력값이 없습니다.","400","domain을 채워 다시 요청합니다."],["Domain 형식이 잘못되었습니다.","400","https://·경로를 지우고 도메인 형식을 확인합니다."],["이 호스트 이름에 대한 기록이 없습니다. …","424","이력이 없는 도메인입니다. 하위 도메인을 보냈다면 등록 도메인(example.com)으로 바꿔 다시 요청합니다."],["알 수 없는 이유로 실패했습니다.","424","일시적인 실패입니다. 잠시 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}