> For the complete documentation index, see [llms.txt](https://a-send.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://a-send.gitbook.io/api/common/rate-limiting.md).

# 제약 사항

### **제한 기준**

API 안정성을 위해 API Key 단위로 **분당 최대 60회** 요청할 수 있습니다.

| 항목      | 값        |
| ------- | -------- |
| 허용 요청 수 | 60회      |
| 시간 범위   | 60초 (1분) |
| 제한 단위   | API Key  |

### **응답 헤더**

모든 API 응답에 아래 헤더가 포함됩니다.

<table><thead><tr><th>헤더</th><th width="144">타입</th><th>설명</th></tr></thead><tbody><tr><td><code>X-RateLimit-Limit</code></td><td>integer</td><td>1분당 허용 횟수</td></tr><tr><td><code>X-RateLimit-Remaining</code></td><td>integer</td><td>남은 요청 가능 횟수</td></tr><tr><td><code>X-RateLimit-Reset</code></td><td>integer</td><td>제한이 초기화되는 Unix Timestamp</td></tr></tbody></table>

### **제한 초과 시**

`429 Too Many Requests` 응답이 반환됩니다.

```json
{
  "message": "Rate limit exceeded",
  "data": null
}
```

#### **권장 대응 방법**

1. `X-RateLimit-Remaining` 헤더를 확인하여 남은 횟수를 사전에 파악합니다.
2. 제한 초과 시 `X-RateLimit-Reset` 시간까지 대기 후 재시도합니다.
3. 대량 발송이 필요한 경우 요청 간 적절한 간격을 두고 호출합니다.