> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 호출 횟수 제한

> API 호출 횟수 제한과 429 응답을 처리하는 방법을 정리합니다.

| 범위 | 제한 |
| - | - |
| 연동 하나의 모든 요청 | 평균 초당 3회, 짧은 순간에는 최대 180회 |
| 연동 하나의 `POST /v1/data_sources/{id}/query` | 초당 약 3회 |

팀의 모든 연동이 함께 쓰는 한도가 있습니다.

이 제한은 바뀔 수 있습니다.

## 429 응답

제한을 넘으면 429 `rate_limited`를 반환합니다. `Retry-After` 헤더에 기다릴 시간이 정수 초로 들어 있습니다.

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/json
```

```json theme={null}
{
  "object": "error",
  "status": 429,
  "code": "rate_limited",
  "message": "You have been rate limited. Please try again in a few minutes.",
  "request_id": "33333333-3333-4333-8333-333333333333",
  "additional_data": {
    "retry_after": "2"
  }
}
```

`additional_data`에는 다른 필드가 포함될 수 있습니다.

## 호출 횟수 제한 처리하기

* `Retry-After`만큼 기다린 뒤 다시 보내세요.
* 큰 데이터베이스를 읽을 때는 `page_size`를 크게 하고 `filter_properties`로 필요한 속성만 고르세요.
* 웹훅을 받아 다시 읽는 서버는 이벤트를 큐에 넣고 제한 안에서 처리하세요.

**참고:** 변경이 몰리면 이벤트도 몰립니다. 연동을 여러 개 만들어도 팀이 함께 쓰는 한도는 늘어나지 않습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.