빠른 답변
WebReaderAPI가 작동 중인지 어떻게 알 수 있나요?
API 키와 함께 GET https://webreaderapi.com/api/v1/credits을 호출하세요. 무료이며, 정상적인 응답이 오면 API와 키가 작동하는 것입니다. 페이지가 실패하면 오류 코드가 이유를 알려주며, WebReaderAPI은 이에 대해 아무것도 청구하지 않습니다. 저희 쪽의 장애는 날짜와 함께 changelog에 기록됩니다.
가장 빠른 상태 확인 방법은 무엇인가요?
크레딧 endpoint입니다. 어떤 웹사이트도 가져오지 않고 응답하므로 저희 쪽만 테스트합니다: 인증, API, 그리고 계정입니다.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
어떤 오류가 웹사이트에서 발생하고, 어떤 오류가 저희 쪽에서 발생하나요?
오류 코드는 문제가 어디에 있는지 알려줍니다. 이 오류 중 어느 것도 크레딧을 사용하지 않습니다.
| 코드 | 문제 위치 | 해야 할 일 |
|---|---|---|
blocked_by_robots | 사이트의 robots.txt가 크롤러를 거부함 | 없음: 사이트가 거부함 |
blocked_by_site_policy | 사이트가 ai-input=no을 선언함 | 없음: 사이트가 거부함 |
target_refused | 사이트가 403, 429, 챌린지 또는 로그인으로 응답함 | 나중에 시도하거나 사이트에 접근을 요청하세요 |
fetch_failed | DNS, TLS, 연결, 또는 404/410 페이지 | URL을 확인하고 나중에 재시도하세요 |
fetch_timeout | 사이트가 제시간에 응답하지 않음 | 더 긴 timeout로 재시도하세요 |
concurrency_limit | 계정에서 동시에 너무 많은 요청 | 속도를 줄이거나 한도를 높여 달라고 요청하세요 |
invalid_api_key, insufficient_credits | API 키 또는 잔액 | 대시보드를 확인하세요 |
오류 페이지에서 각 경우를 재시도 루프와 함께 자세히 설명합니다.
여기에 실시간 가동률 수치가 없는 이유는 무엇인가요?
아직 공개 샘플로 측정한 적이 없으며, 지어낸 수치는 오해를 불러일으킬 수 있기 때문입니다. 읽기 성공 여부는 대부분 읽는 대상 사이트에 달려 있으므로 단일 백분율은 의미가 적습니다. 수치를 공개하게 되면 방법, 샘플, 날짜와 함께 제공할 것입니다.
장애는 어디에 공지되나요?
changelog에 날짜, 영향을 받은 endpoint, 그리고 조치 내용과 함께 공지됩니다. 저희 쪽에서 반복적인 오류(대상 사이트로 인한 오류가 아닌 코드)가 보인다면 요청 시간과 오류 코드를 [email protected]으로 보내주세요.
상태: 자주 묻는 질문
크레딧을 확인하는 데 비용이 드나요?
아니요. GET https://webreaderapi.com/api/v1/credits은 크레딧을 사용하지 않으므로 동시성 한도 내에서 상태 확인용으로 얼마든지 호출할 수 있습니다.
제 쪽에서는 페이지가 실패하지만 브라우저에서는 열립니다. 왜 그런가요?
보통 사이트가 사람과 로봇을 다르게 취급하기 때문입니다: robots.txt에서 저희 크롤러를 거부하거나 자동화된 요청에 챌린지 페이지로 응답할 수 있습니다. 저희는 사이트의 응답을 그대로 반환하며 아무것도 청구하지 않습니다. 오류 코드와 target_status이 사이트가 보낸 내용을 보여줍니다.
실패한 읽기에도 요금이 부과되나요?
아니요. 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다.