> This page is for 플랫폼, version 레거시.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 실험적: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 레거시: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# API 오류 코드

Frame.io API는 다음과 같은 일반적인 오류를 반환할 수 있습니다.




| 코드 | 세부 사항 | 이유 |
| ---------- | ---------- | ---------- |
| `401` | **Unauthorized** -- 잘못된 API 토큰입니다. Bearer 토큰 인증을 사용하고 있는지 확인하고 Authorization 헤더를 통해 토큰을 전달하세요. |  |
| `402` | **Usage exceeded** -- Frame.io 요금제 한도를 초과했습니다. |  |
| `403` | **Forbidden** -- 해당 리소스에 액세스할 수 없습니다. 사용자 액세스 및 토큰 범위 모두에 대해 반환됩니다. |  |
| `404` | **Not Found** -- 리소스를 찾을 수 없습니다. | 리소스가 이동되었거나 삭제되었습니다. |
| `422` | **Invalid arguments** -- 제공된 하나 이상의 매개변수가 잘못되었습니다. |  |
| `429` | **Rate Limited** -- API 요청 제한에 도달했습니다. |  |
| `500` | **Server Error** -- 서버가 요청을 해석할 수 없거나 가용 시간(30초) 내에 요청을 완료할 수 없습니다. | 요청 URL이나 본문이 잘못되었거나, 기타 이유로 완료할 수 없습니다. |




# 일반적인 오류 문제 해결

일반적인 작업을 수행하기 위해 유효한 API 토큰을 사용할 때 가장 일반적인 오류는 `403`, `404`, `500`입니다. **403** 오류는 일반적으로 다음 세 가지 시나리오 중 하나를 나타냅니다.
1. 요청에 사용된 토큰 및/또는 토큰이 속한 사용자에게 리소스가 요청된 Frame.io 계정 영역에 대한 충분한 액세스 권한이 없습니다.
2. 토큰에 요청된 리소스에 대한 [Scopes]()가 충분하지 않습니다. 예: `comments.read` 범위 없이 `GET /comments/`를 호출합니다.
3. 네트워크 트래픽 문제로 인해 Frame.io API가 요청을 처리할 수 없습니다. *네트워크 트래픽 문제로 인해 요청이 차단된 것으로 의심되는 경우 고객 지원팀에 문의하세요.*

**404** 오류는 일반적으로 리소스가 더 이상 존재하지 않음을 나타냅니다 -- 이동되었거나 삭제되었습니다. **500** 오류는 일반적으로 잘못된 형식의 요청 URL이나 본문을 나타내지만, 가용 시간(30초) 내에 요청을 완료할 수 없는 경우에도 발생할 수 있습니다.

# 요청 제한

Frame.io API는 토큰당 요청 제한을 적용합니다. 토큰의 기본 제한은 초당 50회 호출입니다. 일부 메서드는 한도가 더 낮습니다(예: POST `/assets/:id/children`은 초당 5개 에셋으로 요청이 제한됨).

모든 제한은 변경될 수 있으며, 제한에 도달하면 429 HTTP 오류를 반환합니다. 요청 제한을 처리할 때 지수 백오프 방식을 사용하는 것이 좋습니다.

자세한 내용은 요청 제한 [가이드](./rate-limits)를 확인하세요.