오류 및 제한
크레딧
섹션 제목: “크레딧”| 이벤트 | 과금 여부 |
|---|---|
| 성공한 요청 (HTTP 200) | 1 크레딧 |
렌더링 활성화 성공 (render_js=1) | 1 크레딧 |
| 실패한 요청 (시간 초과, 연결 오류) | 0 크레딧 |
| 대상으로부터의 HTTP 4xx 또는 5xx | 0 크레딧 |
| 하나의 호출 내 재시도 | 하나의 상위 호출로 집계 |
2xx 상태와 비어 있지 않은 본문으로 도달한 응답에 대해서만 과금됩니다.
동시성
섹션 제목: “동시성”| 플랜 | 최대 동시 요청 수 |
|---|---|
| Starter | 20 |
| Growth | 50 |
| Business | 100 |
| Enterprise | 500 |
한도를 초과하는 요청은 429 Too Many Requests를 반환합니다. 지수 백오프로 대기한 후 재시도하세요.
오류 코드
섹션 제목: “오류 코드”| 상태 | 의미 | 조치 사항 |
|---|---|---|
200 | 성공, 응답 본문 첨부됨 | 정상적으로 처리 |
400 | 잘못된 요청 (매개변수 형식 오류) | extract_rules 또는 url 매개변수를 수정 |
401 | 유효하지 않거나 누락된 api_key | 패널에서 키를 확인 |
403 | 플랜에서 지원하지 않는 기능 | 업그레이드하거나 플래그를 제거 (예: Starter에서의 premium_proxy) |
408 | 대상 사이트 시간 초과 | 더 높은 timeout= 값 또는 더 단순한 옵션으로 재시도 |
422 | 렌더링 실패 (JS 충돌, 탐색 오류) | 재시도; 실제 브라우저에서 사이트가 작동하는지 확인 |
429 | 동시성 한도 초과 | 대기 후 재시도 |
500 | Shifter 내부 오류 | 잠시 후 재시도, 지속되면 지원팀에 문의 |
509 | 플랜 크레딧 소진 | 업그레이드하거나 다음 결제 주기를 대기 |
자동 재시도
섹션 제목: “자동 재시도”실패한 가져오기, CAPTCHA, 대상의 일시적인 5xx 오류는 엔드포인트가 오류를 반환하기 전에 서로 다른 프록시로 최대 3회까지 자동으로 재시도됩니다. 재시도에 대해서는 과금되지 않습니다.
웹훅 전달
섹션 제목: “웹훅 전달”장시간 실행되는 스크래핑 작업의 경우, webhook=<URL>을 전달하면 준비된 응답이 엔드포인트로 POST됩니다:
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"성공적인 전달 1건당 1 크레딧이 여전히 과금됩니다.
모니터링
섹션 제목: “모니터링”실시간 크레딧 사용량과 오류율은 패널의 Web Scraping API → Usage에서 확인할 수 있습니다.