제한과 오류
속도 제한, 크기 제한, 웹사이트가 Atlas에서 받을 수 있는 오류 코드입니다.
이 페이지는 영어에서 번역되었습니다. 내용이 다를 경우 영어 버전이 우선합니다. 영어로 읽기
속도 제한
섹션 제목: “속도 제한”| 영역 | 제한 |
|---|---|
| Delivery API | 현재 요청별 제한 없음. 응답을 캐시하고 ETag를 사용하세요. 제한이 추가될 수 있습니다 |
| 폼 제출 | 10분당: 사이트 300회, 폼 120회, IP 주소 12회, 방문자 세션 6회 |
| 챗봇 대화 | IP 주소당 10분에 새 대화 10개 |
| 챗봇 메시지 | IP 주소당 10분에 40개, 대화당 80개 |
| 페이지 조회 비콘 | IP 주소와 환경당 분당 120회 |
| MCP(AI 에이전트) | 연결당 기본 분당 120회 호출 |
| Leads API | 키당 분당 300회 요청 |
| Core Web Vitals | 환경당 시간당 수동 검사 3회 |
제한에 도달하면 Atlas는 429로 응답합니다. 기다린 뒤 백오프를 두고 다시 시도하세요.
크기 제한
섹션 제목: “크기 제한”| 항목 | 제한 |
|---|---|
/routes가 반환하는 경로 |
5,000 |
| 요청당 항목 | 100(limit) |
| 리전당 섹션 | 60 |
| 폼 제출 하나의 필드 | 30 |
| 챗 메시지 | 1,000자 |
| 배포 보고서의 컴포넌트 | 500 |
| MCP 요청 본문 | 3 MB |
| 미리보기 링크 유효 시간 | 15분 |
| 서명된 미디어 링크 유효 시간 | 15분 |
| CSV 내보내기 하나의 리드 | 50,000 |
| 활성 Leads API 키 | 환경당 20개 |
| CRM 연결 | 환경당 10개 |
llms.txt의 페이지 |
2,000 |
요금제에 따라 사이트 수, 사용자 수, 저장 공간, 언어 수도 정해집니다.
일반적인 오류 코드
섹션 제목: “일반적인 오류 코드”| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | CP_UNAUTHENTICATED |
토큰이 없거나, 잘못되었거나, 만료되었거나, 취소되었습니다 |
| 400 | FILTER_INVALID |
항목의 filter 또는 sort를 읽을 수 없습니다 |
| 403 | ORIGIN_DENIED |
사이트에 등록되지 않은 출처에서 브라우저 요청이 왔습니다 |
| 403 | CP_PRODUCTION_LOCKED |
프로덕션은 켜져 있지만 서명된 라이브 릴리스가 아직 없거나, 개발 환경 전용 작업입니다 |
| 409 | SITE_ADDRESS_MISSING |
환경에 아직 웹사이트 주소가 없습니다 |
| 403 | PREVIEW_INVALID |
미리보기 링크가 올바르지 않습니다 |
| 404 | CP_NOT_FOUND |
알 수 없는 환경이거나 게시된 것이 없습니다 |
| 404 | LOCALE_UNSUPPORTED |
사이트가 해당 로케일을 지원하지 않습니다 |
| 404 | FEED_NOT_EDITORIAL |
피드는 편집용 컬렉션에만 있습니다 |
| 409 | CONVERSATION_FULL |
챗 대화가 80개 메시지에 도달했습니다 |
| 410 | PREVIEW_EXPIRED |
미리보기 링크가 15분보다 오래되었습니다 |
| 422 | SUBMISSION_INVALID |
폼 필드가 검증에 실패했습니다 |
| 400 | SUBMISSION_REJECTED |
폼 제출이 거부되었습니다 |
| 428 | BOT_CHALLENGE_REQUIRED |
Turnstile 챌린지를 완료하고 다시 시도하세요 |
| 429 | RATE_LIMITED |
요청이 너무 많습니다 |
웹사이트는 모든 5xx 또는 타임아웃을 “Atlas 사용 불가”로 취급하고 내장 폴백을 제공해야 합니다.