> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/api-guide/rate-limit.md).

# 요청 제한

## 요청 제한 정책 <a href="#rate-limit-policy" id="rate-limit-policy"></a>

요청 제한은 시간 단위당 API 호출 횟수 제한을 의미합니다. DFINERY는 안정적인 서비스 운영을 위해 제공하는 모든 Open API에 요청 제한 정책을 적용합니다.

| 분류                                                                           | Rate Limit (기본)   |
| ---------------------------------------------------------------------------- | ----------------- |
| [Event](https://docs.dfinery.ai/api-guide/api/import-api/event-api.md)       | 1분당 100,000건      |
| [Identity](https://docs.dfinery.ai/api-guide/api/import-api/identity-api.md) | 1분당 10,000건       |
| [Profile](https://docs.dfinery.ai/api-guide/api/import-api/profile.md)       | 1분당 10,000건       |
| [Export](https://docs.dfinery.ai/api-guide/api/export-api/export.md)         | 1시간당 100건, 동시간 5건 |

{% hint style="danger" %}
요청 제한을 초과하면 이후의 API 요청은 모두 실패합니다. 제한 시간이 지나 요청 제한이 초기화된 후 정상 응답을 받을 수 있습니다. API 연동 시 요청 제한을 고려하여 연동하는 것이 좋습니다.
{% endhint %}

{% hint style="info" %}
기본으로 제공되는 요청 제한보다 많은 호출이 필요하다면 고객 성공팀에 문의 부탁드립니다.
{% endhint %}

## 요청 제한 초과 시 응답

{% hint style="info" %}
요청 제한 관련 응답 헤더(`X-Rate-Limit-*`)와 `Retry-After` 헤더는 제공하지 않습니다.
{% endhint %}

### Import API (Event, Identity, Profile)

요청 횟수는 액세스 토큰별로 1분 단위 고정 구간으로 집계되며, 매 분 0초(UTC 기준)에 초기화됩니다.

요청 제한을 초과하면 **HTTP 200** 과 함께 응답 본문의 `code` 로 `40401` (`TOO_MANY_REQUEST`) 이 반환됩니다. 전체 응답 코드는 [상세 응답](https://docs.dfinery.ai/api-guide/api/import-api/response.md)을 참고해주세요.

{% hint style="warning" %}
응답 본문의 `code` 값을 확인하고, `40401` 을 받은 경우 다음 분이 시작된 후 재시도해주세요.
{% endhint %}

#### 정상 응답

```json
200 OK
{
  "status": true,
  "code": 20000,
  "message": "OK",
  "data": null
}
```

#### 요청 제한을 초과한 경우

```json
200 OK
{
  "status": false,
  "code": 40401,
  "message": "TOO_MANY_REQUEST",
  "data": null
}
```

### Export API

요청 제한을 초과하면 **HTTP 429** (Too Many Requests) 가 반환됩니다.
