# 요청 제한

## 요청 제한 정책

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

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

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

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

## 요청 제한 현황 확인

요청 제한 현황은 응답 헤더의 값을 통해 확인할 수 있습니다.

| 헤더 이름                        | 설명              |
| ---------------------------- | --------------- |
| **`X-Rate-Limit-Limit`**     | 초기화 주기          |
| **`X-Rate-Limit-Remaining`** | 남은 요청 횟수        |
| **`X-Rate-Limit-Reset`**     | 발송 속도가 초기화되는 시간 |

{% hint style="info" %}
**X-Rate-Limit-Limit** 은 `1y: 1년, 1M: 1개월, 1d: 1일, 1H: 1시간, 1m: 1분, 1s: 1초`로 구성됩니다.

**X-Rate-Limit-Rest** 은 Timestamp 형식입니다. `1719397769`
{% endhint %}

## 요청 제한 현황 응답 예시

### 정상 응답

```shell
curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 200
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 99999
> x-ratelimit-reset: 1682593200268
```

### API 호출 제한을 초과하는 경우 (응답 코드 429)

```shell
curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 429
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 0
> x-ratelimit-reset: 1682640000000
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dfinery.ai/api-guide/rate-limit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.