# WebReaderAPI 상태: API가 작동하는지 확인하는 방법

> WebReaderAPI 웹 리더 API가 작동하는지 확인하는 방법: 무료 크레딧 endpoint, 각 오류 코드의 의미, 그리고 장애 공지 위치를 안내합니다.

- URL: https://webreaderapi.com/ko/status/
- 마지막 업데이트: 2026-10-22
- 발행자: WebReaderAPI (https://webreaderapi.com)

페이지가 반환되지 않을 때 원인은 보통 웹사이트이고, 때로는 네트워크이며, 저희 쪽인 경우는 드뭅니다. 이 페이지에서는 크레딧을 사용하지 않고 몇 초 만에 어느 쪽인지 구분하는 방법을 보여줍니다.

**빠른 답변 — WebReaderAPI가 작동 중인지 어떻게 알 수 있나요?**

API 키와 함께 `GET https://webreaderapi.com/api/v1/credits`을 호출하세요. 무료이며, 정상적인 응답이 오면 API와 키가 작동하는 것입니다. 페이지가 실패하면 오류 코드가 이유를 알려주며, **WebReaderAPI**은 이에 대해 아무것도 청구하지 않습니다. 저희 쪽의 장애는 날짜와 함께 [changelog](https://webreaderapi.com/ko/changelog/)에 기록됩니다.

## 가장 빠른 상태 확인 방법은 무엇인가요?

크레딧 endpoint입니다. 어떤 웹사이트도 가져오지 않고 응답하므로 저희 쪽만 테스트합니다: 인증, API, 그리고 계정입니다.

*curl: API와 남은 크레딧 확인*

```bash
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 키 또는 잔액 | 대시보드를 확인하세요 |

[오류 페이지](https://webreaderapi.com/ko/docs/errors/)에서 각 경우를 재시도 루프와 함께 자세히 설명합니다.

## 여기에 실시간 가동률 수치가 없는 이유는 무엇인가요?

아직 공개 샘플로 측정한 적이 없으며, 지어낸 수치는 오해를 불러일으킬 수 있기 때문입니다. 읽기 성공 여부는 대부분 읽는 대상 사이트에 달려 있으므로 단일 백분율은 의미가 적습니다. 수치를 공개하게 되면 방법, 샘플, 날짜와 함께 제공할 것입니다.

## 장애는 어디에 공지되나요?

[changelog](https://webreaderapi.com/ko/changelog/)에 날짜, 영향을 받은 endpoint, 그리고 조치 내용과 함께 공지됩니다. 저희 쪽에서 반복적인 오류(대상 사이트로 인한 오류가 아닌 코드)가 보인다면 요청 시간과 오류 코드를 support@webreaderapi.com으로 보내주세요.

## 상태: 자주 묻는 질문

### 크레딧을 확인하는 데 비용이 드나요?

아니요. `GET https://webreaderapi.com/api/v1/credits`은 크레딧을 사용하지 않으므로 동시성 한도 내에서 상태 확인용으로 얼마든지 호출할 수 있습니다.

### 제 쪽에서는 페이지가 실패하지만 브라우저에서는 열립니다. 왜 그런가요?

보통 사이트가 사람과 로봇을 다르게 취급하기 때문입니다: robots.txt에서 저희 크롤러를 거부하거나 자동화된 요청에 챌린지 페이지로 응답할 수 있습니다. 저희는 사이트의 응답을 그대로 반환하며 아무것도 청구하지 않습니다. 오류 코드와 `target_status`이 사이트가 보낸 내용을 보여줍니다.

### 실패한 읽기에도 요금이 부과되나요?

아니요. 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다.

---

WebReaderAPI: WebReaderAPI는 AI 에이전트를 위한 웹 리더 API로, 모든 공개 웹페이지를 깔끔한 Markdown으로 변환하며 신분증 업로드 없이 암호화폐로 결제합니다. US$0.07/1K 페이지부터 시작하는 선불 크레딧은 만료되지 않으며, robots.txt를 준수합니다. KYC 없음 — 신분증도, 셀피도, 서류도 없습니다. 암호화폐로 결제하세요.