{"openapi":"3.0.3","info":{"title":"APICK URL HTML 추출","version":"1.0.0","description":"입력한 URL의 HTML을 추출합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/url_html":{"post":{"summary":"URL HTML 추출","description":"입력한 URL의 HTML을 추출합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"search_result_page":{"type":"string","description":"최종 페이지 주소입니다. 리디렉션이 있었다면 요청한 url과 다릅니다."},"html":{"type":"string","description":"페이지의 HTML 전체입니다. 크기가 큰 페이지는 수 MB가 될 수 있습니다."},"illegal_score":{"type":"integer","description":"페이지가 성인·도박·불법 복제·마약·사기 같은 불법·유해 서비스를 제공하거나 광고할 가능성 점수(0~100)입니다. 클수록 가능성이 높습니다."},"illegal_category":{"type":"string","description":"점수가 50 이상일 때 가장 가까운 범주입니다. adult·gambling·piracy·drugs·fraud·other_crime, 해당 없으면 none입니다. 응답에 없을 수도 있으니 없으면 illegal_score만으로 판단하세요."},"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":{"url":{"type":"string","description":"조회할 대상의 URL입니다. http·https를 포함한 전체 주소를 보내며, 서비스에 따라 영상 ID만 받을 수도 있습니다. (string)","example":"https://apick.app"}},"required":["url"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["data.error","HTTP","대처"],"rows":[["필수 입력값이 없습니다.","400","url을 채워 다시 요청합니다."],["알 수 없는 이유로 실패했습니다.","424","주소가 http·https가 아니거나, 공개 인터넷 주소가 아니거나, 페이지가 열리지 않은 경우입니다. 브라우저에서 주소가 열리는지 확인한 뒤 다시 요청합니다."],["처리 시간 초과로 실패했습니다. 잠시후 다시 시도해 주세요.","408","data.success가 3입니다. 잠시 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}