{"openapi":"3.0.3","info":{"title":"APICK URL 유사도 비교","version":"1.0.0","description":"입력한 두 사이트의 유사 여부를 판단합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/url_similarity":{"post":{"summary":"URL 유사도 비교","description":"입력한 두 사이트의 유사 여부를 판단합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"style":{"type":"integer","description":"스타일(디자인) 유사도 0~1입니다. 1에 가까울수록 색·글꼴·배치 같은 스타일이 비슷합니다."},"structural":{"type":"number","description":"HTML 구조 유사도 0~1입니다. 1에 가까울수록 태그 구성과 배치가 비슷합니다."},"total":{"type":"number","description":"전체 유사도 0~1입니다. 스타일과 구조 유사도를 함께 반영한 값입니다."},"success":{"type":"integer","description":"1이면 정상 처리되어 과금된 응답입니다. 시간 초과로 실패하면 3입니다."},"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":{"url1":{"type":"string","description":"비교할 첫 번째 페이지의 전체 URL입니다. http·https를 포함해 보내며, 두 URL이 모두 열려 있어야 비교할 수 있습니다. (string)","example":"https://apick.app"},"url2":{"type":"string","description":"비교할 두 번째 페이지의 전체 URL입니다. 첫 번째 URL과 같은 형식으로 보내며, 로그인·차단 페이지는 비교가 실패할 수 있습니다. (string)","example":"https://example.com"}},"required":["url1","url2"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["필수 입력값이 없습니다.","400","url1과 url2를 모두 채워 다시 요청합니다."],["알 수 없는 이유로 실패했습니다.","424","두 주소 중 하나가 http·https 공개 주소가 아니거나 페이지가 열리지 않았습니다. 브라우저에서 두 주소가 열리는지 확인합니다."],["페이지 정보를 로딩할 수 없습니다.","424","두 페이지를 비교하지 못했습니다. 잠시 뒤 다시 요청합니다."],["처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.","408","data.success가 3입니다. 잠시 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}