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 오류는 일반적으로 다음 세 가지 시나리오 중 하나를 나타냅니다.

요청에 사용된 토큰 및/또는 토큰이 속한 사용자에게 리소스가 요청된 Frame.io 계정 영역에 대한 충분한 액세스 권한이 없습니다.
토큰에 요청된 리소스에 대한 Scopes가 충분하지 않습니다. 예: comments.read 범위 없이 GET /comments/를 호출합니다.
네트워크 트래픽 문제로 인해 Frame.io API가 요청을 처리할 수 없습니다. 네트워크 트래픽 문제로 인해 요청이 차단된 것으로 의심되는 경우 고객 지원팀에 문의하세요.

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

요청 제한

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

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

자세한 내용은 요청 제한 가이드를 확인하세요.